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PREFACE 


MANUAL OBJECTIVES 


This manual describes the VAX-11l1 MACRO language. It includes’ the 
format and function of each feature of the language. The VAX-11 MACRO 
User's Guide describes how to use VAX-11 MACRO. 


INTENDED AUDIENCE 


This manual is intended for all programmers’ writing VAX-11 MACRO 
programs. Programmers should be familiar with assembly language 
programming, the VAX-11 instruction set, and the VAX/VMS' operating 
system before reading this manual. 


The VAX-11 MACRO User's Guide provides a brief introduction to the 
assembler and describes the commands necessary to use VAX-11 MACRO. 
The VAX-1l Architecture Handbook describes the VAX-11 instruction set. 
All programmers should read these manuals before using this language 
reference manual. 


STRUCTURE OF THIS DOCUMENT 


This manual is organized into six chapters and four appendixes, as 
follows: 


e Chapter 1 introduces the features of the VAX-11 MACRO 
language. 


e Chapter 2 describes the format used in VAX-11 MACRO source 
statements. 


e Chapter 3 describes the components of VAX-11 MACRO source 
statements: the character set; numbers; symbols; local 
labels; terms and expresSions; unary and binary operators; 
direct assignment statements; and the current’ location 
counter. 


e Chapter 4 summarizes and gives examples of the use of the 
VAX-11 MACRO addressing modes. 


e Chapter 5 describes the VAX-11 MACRO general assembler 
directives. 
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e Chapter 6 describes the directives used in defining and 
expanding macros. 


e Appendix A lists the ASCII character set that can be used in 
VAX-11 MACRO programs. 


e Appendix B summarizes the general assembler and macro 
directives (in alphabetical order), special characters, unary 
operators, binary operators, and addressing modes. 


e Appendix C lists alphabetically and by opcode the permanent 
symbols (instruction set) defined for use with VAX-11 MACRO. 


e Appendix D gives rules for hexadecimal/decimal conversion. 


ASSOCIATED DOCUMENTS 
The following documents are relevant to VAX-11 MACRO programming: 
@e VAX-11 Architecture Handbook 
e VAX-11 MACRO User's Guide 
e VAX/VMS Command Language User's Guide 
e VAX-11 Linker Reference Manual 
e VAX-11 Symbolic Debugger Reference Manual 


For a complete list of all VAX-11 documents, including a brief 
description of each, see the VAX-1l Information Directory and Index. 


CONVENTIONS USED IN THIS DOCUMENT 


The following conventions are observed in this manual, as in the other 
VAX-11 documents: 


Convention Meaning 
Uppercase words Uppercase words and letters, used in 
and letters examples, indicate that you should type the 
word or letter exactly as shown. 
Lowercase words Lowercase words and letters, used in format 
and letters examples, indicate that you are to substitute 


a word or value of your choice. 


[ ] Square brackets indicate that the enclosed 
item is optional. 


eee A horizontal ellipsis indicates that the 
preceding item(s) can be repeated one or more 
times. 

2 A vertical ellipsis indicates that not all of 

* the statements in an example or figure are 

° shown. 
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SUMMARY OF TECHNICAL CHANGES 


This manual documents VAX-11 MACRO V2.0, as released with Release 2.0 
of VAX/VMS. This section summarizes the technical changes from the 
last version, released with Release 1.5 of VAX/VMS. 


Changes affecting directives: 


There is a new data type, the octaword, which stores 128 bits (16 
bytes) of binary data. The octaword storage directive is .OCTA. A 
new block storage directive, .BLKO, reserves octawords for data. A 
new operand generation directive, .REF16, generates an octaword 
operand. However, DIGITAL recommends using the opcode definition 
directive, .OPDEF, instead of .REF; there are new operand descriptors 
for use with .OPDEF which describe octaword operators. 


Two new floating-point directives provide additional flexibility and 
capacity for floating-point numbers. The .G FLOATING directive 
generates 64-bit data (quadwords) of which one bit is the sign, 11 
bits are exponent, and 52 bits are fraction. The .H_ FLOATING 
directive generates 128-bit data (octawords) with one bit for sign, 15 
bits for exponent, and 112 bits for fraction. There are new block 
Storage directives, .BLKG and .BLKH, which reserve G floating 
quadwords and H_ floating octawords, respectively. There are new 
operand descriptors for use with .OPDEF which describe G floating and 
H_ floating operands. (Note: not all VAX-11 processors support the 
G_ floating and H floating data types.) 


To bring the formats of the floating-point data types and directives 
into a consistent format, there are new alternate forms of the .FLOAT 
directive — .F FLOATING — and the .DOUBLE directive — .D FLOATING. 
The terms F floating and D floating are used in this manual to denote 
single-precision and 64-bit double precision data. 


A new program section attribute, VEC, has been added for use with’ the 
»~PSECT directive. It Shows that a program section contains 
information to be used in a privileged shareable image. 


The new directives, attributes, and operand descriptors listed above 
are all described under the directive names in Chapter 5. 


New opcodes have been added to the VAX-11 instruction set to make use 
of octaword, G floating, and H floating data. These opcodes, and the 
mnemonics that represent them in source code, are listed in Appendix 
Cc. 
Miscellaneous changes: 
e User-defined symbols may now be up to 31 characters long. 
e The ASCII string used with the ASCII operator (“A) may now be 
up to 16 characters long, depending on the data type of the 
operand. 


e Source statements used within macros may now be up to 1000 
characters long. . 
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CHAPTER 1 


INTRODUCTION 


The VAX-11 MACRO programming language is an assembly language for 
programming VAX-1l1 computers under the VAX/VMS' operating system. 
Source programs written in the VAX-11l MACRO programming language are 
translated into object (or binary) code by the VAX-11 MACRO assembler, 
which produces an object module and, optionally, a listing file. 
These functions of the assembler are described in the VAX-11 MACRO 
User's Guide. The features of the language itself are introduced in 
this chapter. 


VAX-11 MACRO source programs consist of a sequence of source 
Statements. These source statements may be any of the following: 


e VAX-11 native-mode instructions 

e Direct assignment statements 

e Assembler directives 
Instructions manipulate data. They perform: such functions as 
addition, data conversion, and transfer of control. Instructions are 
usually followed in the source statement by operands, which can be any 
kind of data needed for the operation of the instruction. The VAX-11 
instruction set is summarized in Appendix C of this volume and is 
described in detail in the VAX-11 Architecture Handbook. 
Direct assignment statements equate symbols to values. 
Assembler directives guide the assembly process and provide tools for 
using the instructions. There are two classes of assembler 
directives: general assembler directives and macro directives. 
General assembler directives can be used to perform the following: 

e Store data or reserve memory for data storage 


e Control the alignment in memory of parts of the program 


e Specify the methods of accessing the sections of memory in 
which the program will be stored. 


e Specify the entry point of the program or of part of the 
program 


e Specify the way in which symbols will be referenced 


e Specify that a part of the program is to be assembled only 
under certain conditions 


INTRODUCTION 


Control the format and content of the listing file 


Display informational messages 


Control the assembler options that are 
source program 


Define new opcodes 


Macro directives are used to define macros and 
allow programmers to do the following: 


Use of macros and repeat blocks helps to 


Repeat identical or similar sequences 
throughout a program 


Use string operators to manipulate and 
source statements 


and to speed the debugging process. 


used to interpret the 


repeat blocks. They 


of source statements 


test the contents of 


minimize programmer’ errors 


CHAPTER 2 


MACRO SOURCE STATEMENT FORMAT 


A source program consists of a sequence of source statements, which 
the assembler interprets and processes, one by one, generating object 


code or performing a specific assembly-time process. A source 
statement can occupy one source line or can extend onto several source 
lines. Each source line can be up to 132 characters’ long; however, 


no line should exceed 80 characters to ensure that the source line 
fits (with its binary expansion) on one line in the listing file. 


MACRO statements can consist of up to four fields: 


e Label field -- symbolically defines a location in a program 
e Operator field -- specifies the action to be performed by the 
statement; this field can be an instruction, an assembler 


directive, or a macro call 


e Operand field -- contains the instruction operand(s) or _ the 
assembler directive argument(s) or the macro argument(s) 


e Comment field -- contains a comment that explains the meaning 
of the statement; this field does not affect program 
execution 


The label field and the comment field are optional. The label field 
ends with a colon (:) and the comment field starts with a semicolon 
(;). The operand field must conform to the format of the instruction, 
directive, or macro specified in the operator field. 


Although statement fields can be separated by either a space or a_ tab 
(see Table 3-2), formatting statements with the tab character is 
recommended for consistency and clarity. By DIGITAL convention, tab 
characters are used to separate the statement fields as follows: 


Field Begins in Column Tab Characters to Reach Column 
Label 1 0 
Operator 9 1 
Operand 17 2 
Comment 41 D 


For example: 


TITLE ROUTI 


ENTRY START,O BEGINNING OF ROUTINE 


; 
CLRL RO ; CLEAR REGISTER 
LABT: SUBL3 #10,4 (AP) R2 ; SUBTRACT 10 
; BRANCH TO ANOTHER ROUTINE 


LAB2: BRB CONT 
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A single statement can be continued on several lines by using a hyphen 
(-) as the last nonblank character before the comment field or at the 
end of line (when there is no comment). For example: 


LAB1: MOVAL W“BOOSAL_VECTOR,- ; SAVE ADDRESS OF 
RPBSL_IOVEC(R7) ; BOOT DEVICE DRIVER. 


VAX-11 MACRO treats the above statement as equivalent to the following 
Statement: 


LAB1l: MOVAL W“BOOSAL_VECTOR,RPBSL_IOVEC(R7) ; SAVE BOOT DRIVER 


A statement can be continued at any point. User-defined and permanent 
symbol names; however, should not be continued on two lines. If a 
symbol name is continued and the first character on the second line is 
a tab or a blank, the symbol name will be terminated at that 
character. (Section 3.3 describes symbols in detail.) 


Note that when a statement occurs in a macro definition (see Chapter 
6), the statement cannot contain more than 1000 characters. 


Blank lines, although legal, have no significance in the_ source 
program except that they terminate a continued line. 


The following sections describe each of the statement fields’ in 
detail. 


2.1 LABEL FIELD 


A label is a user-defined symbol that identifies a location in the 
program. The symbol is assigned a value equal to the location counter 
at the location in the program section in which the label occurs’ (see 
the VAX-11 MACRO User's Guide for information on program sections). 
The user-defined symbol name can be up to 31 characters long and can 
contain any alphanumeric character and the underline(_), dollar sign 
($), and period (.) characters. Section 3.3 describes the rules’ for 
forming user-defined symbol names in more detail. 


If a statement contains a label, the label must be in the first field 
on the line. 


A label is terminated by a colon (:) or a double colon (::). A single 
colon indicates that the label is defined only for the current module 
(an internal symbol). A double colon indicates that the label is 
globally defined; that is, the label can be referenced by other 
object modules (see Section 3.3.2). 


Once a label is defined, it cannot be redefined during the source 
program. If a label is defined more than once, VAX-11 MACRO displays 
an error message when the label is defined and again when it is 
referenced. 


If a label extends past column 7, it should be placed on a line by 
itself so that the operator field can start in column 9. 
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For example: 


DATA:: .BLKW 20 DATA TABLE ACCESSED BY STORE 


ROUTINE IN ALGO MODULE 


EVAL: CLRL RO ; ROUTINE EVALUATES EXPRESSIONS 
ERROR IN ARG: ; THE ARG-LIST CONTAINS AN ERROR 
™~ INCL RO ; INCREMENT ERROR COUNT 
TEST:: MOVO EXP,R1 ; THIS TESTS ROUTINE 
; REFERENCED EXTERNALLY 
TEST1: BRW EXIT ROU ; GO TO EXIT ROUTINE 
EXP: -BLKL 50 _ + TABLE STORES EXPECTED VALUES 
c 


The label field is also used for the symbol in a direct assignment 
statement (see Section 3.8). 


2.2 OPERATOR FIELD 


The operator field specifies the action to be performed by the 
statement. This field can contain either an instruction, or an 
assembler directive, or a macro call. 


When the operator is an instruction, VAX-11 MACRO generates the binary 
code for that instruction in the object module. The binary codes are 
listed in Appendix C of this manual; the instruction set is described 
in the VAX-11 Architecture Handbook. When the operator is a 
directive, VAX-11 MACRO performs certain control actions or processing 
operations during source program assembly; the assembler directives 
are described in Chapters 5 and 6 of this manual. When the operator 
is a macro call, VAX-11 MACRO expands the macro; macro calls are 
described in Chapter 6. 


Either a space or a tab character may terminate the operator field; 
however, the tab is the recommended terminating character. 


2.3 OPERAND FIELD 


The operand field can contain operands for instructions or arguments 
for assembler directives or macro calls. 


Operands for instructions identify the memory locations or _ the 
registers that are used by the machine operation. These operands 
specify the addressing mode for the instruction, as described in 
Chapter 4 of this manual. The operand field for a_ specific 
instruction must contain the number of operands’ required by that 
instruction. See the VAX-1l Architecture Handbook for descriptions of 
the instructions and their operands. 


Arguments for a directive must meet the format requirements of the 
directive. Chapters 5 and 6 describe the directives and the format of 
their arguments, 


Operands for a macro must meet the requirements specified in the macro 
definition. See the description of the .MACRO directive in Chapter 4. 


If two or more operands are specified, they should be separated by 
commas. VAX-11 MACRO also allows a_= space or tab to be used as a 
separator for arguments to any directive that does not accept 
expressions (see Section 3.5). However, a comma is required to 
Separate operands for instructions and for directives that accept 
expressions as arguments. 
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The semicolon that starts the comment field terminates the operand 
field. If a line does not have a comment field, the operand field is 
terminated by the end of the line. 


2.4 COMMENT FIELD 


The comment field contains text that explains the function of the 
statement. Every line of code should have a comment. Comments do not 
affect assembly processing or program execution except for messages 
displayed during assembly by the .ERROR, .PRINT, and .WARN directives 
(see descriptions in Chapter 5). 


The comment field must be preceded by a semicolon and is terminated by 
the end of the line. The comment field can contain any printable 
ASCII character (see Appendix A). 


If a comment does not fit on one line, it can be continued on the 
next, but the continuation must be preceded by another semicolon. A 
comment can appear on a line by itself. 


The text of a comment normally conveys the meaning rather than the 
action of the statement. The instruction MOVAL BUF PTR_1,R7, for 
instance, should have a comment such as "GET POINTER TO FIRST BUFFER" 
not “MOVE ADDRESS OF BUF PTR 1 TO R7." 


For example: 


GET ADDRESS OF STRING 
DESCRIPTOR 

GET LENGTH OF STRING 
GET ADDRESS OF STRING 


MOVAL STRING DES 1,R0 


MOVZWL (RO),R1 
MOVL 4(RO) ,RO 


me ™e Ne Oe 


CHAPTER 3 


THE COMPONENTS OF MACRO SOURCE STATEMENTS 


This chapter describes the components of VAX-11 MACRO source 


statements. These components consist of the character set; numbers; 
symbols; local labels; terms and expressions; unary and binary 
operators; direct assignment statements; and the current location 
counter. 


3.1 CHARACTER SET 


The following characters can be used in VAX-11 MACRO source 
statements: 


e Both uppercase and lowercase letters (A through Z, a_ through 
z) are accepted. However, the assembler considers lowercase 
letters equivalent to uppercase except when they appear in 
ASCII. strings. 

e The digits 0 through 9. 

e The special characters listed in Table 3-1. 


Table 3-1 
Special Characters Used in VAX-11 MACRO Statements 


Underline Character in symbol names 

Dollar sign Character in symbol names 

Period Character in symbol names, 
current location counter, and 


decimal point 


Colon Label terminator 


Equal sign Direct assignment operator and 
macro keyword argument terminator 


Tab Field terminator 


Space Field terminator 





(continued on next line) 


Character 


=e 


0 


() 


<> 


ae) 
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Table 3-1 (Cont.) 
Special Characters Used in VAX-11 MACRO Statements 


Character Name 


Number sign 


At sign 


Comma 
Semicolon 


Plus sign 


Minus sign or 
hyphen 


Asterisk 


Slash 
Ampersand 


Exclamation 
point 


Backslash 


Circumflex 


Square brackets 


Parentheses 


Angle brackets 


Question mark 


Apostrophe 


Percent sign 


pun th agate A seen 


Function 


Immediate addressing mode 
indicator 


Deferred addressing mode 
indicator and arithmetic shift 
operator 


Field, operand, and item 
separator 


Comment field indicator 
Autoincrement addressing mode 
indicator, unary plus operator, 
and arithmetic addition operator 
Autodecrement addressing mode 
indicator, unary minus operator, 
arithmetic subtraction operator, 
and line continuation indicator 


Arithmetic multiplication 
operator 


Arithmetic division operator 
Logical AND operator 

Logical inclusive OR operator 
Logical exclusive OR and numeric 
conversion indicator in macro 


arguments 


Unary operators and macro 
argument delimiter 


Index addressing mode and repeat 
count indicators 


Register deferred addressing mode 
indicators 


Argument or expression grouping 
delimiters 


Created label indicator in macro 
arguments 


Macro argument concatenation 
indicator 


Macro string operators 


THE COMPONENTS OF MACRO SOURCE STATEMENTS 
Table 3-2 defines the separating characters used in VAX-11 MACRO. 


Table 3-2 
Separating Characters in VAX-11 MACRO Statements 


Character Name 


Space or tab Separator between statement 
fields. Spaces within 
expressions (see Section 3.5) are 
ignored. 


Separator between symbolic 
arguments within the operand 
field. Multiple expressions in 
the operand field must be 
separated by commas. 





3.2 NUMBERS 


Numbers can be integers, floating-point numbers, or packed decimal 
strings. 


3.2.1 Integers 


Integers can be used in any expression including expressions in 
operands and in direct assignment statements (Section 3.5 describes 
expressions). 


Format 
snn 
Ss 
An optional sign: plus sign (+) for positive numbers (the 


default) or minus sign (-) for negative numbers. 


nn 


A string of numeric characters that are legal for the current 
radix. 


VAX-11 MACRO interprets all integers in the source program as decimal 
unless the number is preceded by a radix control operator (see Section 
3.6.1). 


Integers must be in the range of -2147483648 through 2147483647 for 
signed data or in the range of 0 through 4294967295 for unsigned data. 


Negative numbers must be preceded by a minus_- sign; VAX-11 MACRO 
translates such numbers into 2's complement’ form. In positive 
numbers, the plus sign is optional. 
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3.2.2 Floating-Point Numbers 


A floating-point number can be used in the .F FLOATING (.FLOAT), 
~D_FLOATING, (.DOUBLE) -G_ FLOATING, and .H FLOATING directives 
(described in Chapter 5) or as an operand in a_ floating-point 
instruction. A floating-point number cannot be used in an expression 
or with a unary or binary operator except the unary plus, unary minus, 
and unary floating-point operator (“F). Sections 3.6 and 3.7 describe 
unary and binary operators. 


A floating-point number can be specified with or without an exponent. 
Formats 
Floating-point number without exponent: 

snn 

snn.nn 


snn. 


Floating-point number with exponent: 


snnEsnn 
snn.nnEsnn 
snn.Esnn 
Ss 
An optional sign. 
nn 


A string of decimal digits in the range of 0 through 9. 


The decimal point can appear anywhere to the right of the first digit. 
However, note that a floating-point number cannot start with a decimal 
point because VAX-11 MACRO will treat the number as a_e user-defined 
symbol (see Section 3.3.2). 


Floating-point numbers can be single-precision (32-bit), 
double-precision (64-bit), or extended-precision (128-bit) quantities. 
The degree of precision is 7 digits for single-precision numbers, 14 
digits for double-precision numbers, and 33 digits for extended 
precision numbers. 


The magnitude of a nonzero floating-point number cannot be smaller 
than approximately 0.29E~-38 or greater than approximately 1.7E38. 


Single-precision floating-point numbers can be rounded (by default) or 
truncated. The .ENABLE and .DISABLE directives (described in Chapter 
5) control whether single-precision floating-point numbers are rounded 
or truncated. Double-precision and extended-precision floating point 
numbers are always rounded. 


The VAX-11 Architecture Handbook describes the internal format of 
floating-point numbers. 
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3.2.3 Packed Decimal Strings 


A packed decimal string can be used only in the .PACKED directive 
(described in Chapter 5). 


Format 


snn 


An optional sign. 


nn 
A string of from 1 to 31 decimal digits in the range of 0 through 
9. 


A packed decimal string cannot have a decimal point or an exponent. 


The VAX-11 Architecture Handbook describes the internal format of 
packed decimal strings. 


3.3 SYMBOLS 


Three types of symbols can be used in VAX-11 MACRO source programs: 
permanent symbols, user-defined symbols, and macro names. 


3.3.1 Permanent Symbols 


Permanent symbols consist of instruction mnemonics (see Appendix C), 
VAX-11 MACRO directives (see Chapters 5 and 6), and register names. 
Instruction mnemonics and directives need not be defined before being 
used in the operator field of a VAX-11 MACRO source statement. 
Register names need not be defined before being used in the addressing 
modes (see Chapter 4). Register names cannot be redefined; that is, 
no user-defined symbol can have one of the register names listed 
below. 


The 16 general registers of the VAX-11l1 processor can be expressed in a 
source program only as follows: 


Register 

Name Processor Register 

RO General register 0 

Rl General register l 

R2 General register 2 

Rll General register 11 

R12 or General register 12 or argument pointer. If R12 is 
AP used aS an argument pointer, the name AP is 


recommended; if R12 is used aS a general register, 
the name R12 is recommended. 


3=5 
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Register 
Name Processor Register 
FP Frame pointer 

SP Stack pointer 

PC Program counter 


3.3.2 User-defined Symbols and Macro Names 


User-defined symbols can be used as labels or can be equated to a 
specific value by a direct assignment statement (see Section 3.8). 


User-defined symbols also can be used in any expression (see Section 
363). 


The following rules govern the creation of user-defined symbols: 


e User-defined symbols’ can be composed of alphanumeric 
characters, underlines (_), dollar signs (S$), and periods (.). 
Any other character terminates the symbol. 


e The first character of a symbol must not be a number. 


e The symbol must be no more than 31 characters’ long and must be 
unique. 


In addition, by DIGITAL convention: 


e The dollar sign ($) is reserved for names defined by DIGITAL. 
This convention ensures that a user-defined name (which does 
not have a dollar’ sign) will not conflict with a 
DIGITAL-defined name (which does have a dollar sign). 


e The period (.) should not be used in any global symbol name 
(see Section 3.3.3) because other languages, such as FORTRAN, 
do not allow periods in symbol names. 


Macro names follow the same rules and conventions as_ user-defined 
symbols (see the description of the .MACRO directive in Chapter 6 for 


more information on macro names). User-defined symbols and macro 
names do not’ conflict; that is, the Same name can be uSed for a 
user-defined symbol and a macro. However, to avoid confusion, 


user-defined symbols and macros should be given different names. 


3.3.3 Determining Symbol Values 


The value of a symbol depends on its use in the program. VAX-11 MACRO 
uses a different method to determine the values of symbols in the 
operator field than it uses to determine the values of symbols in the 
operand field. 


A symbol in the operator field can be either a permanent symbol or a 
macro name. VAX-11 MACRO searches’ for a symbol definition in the 
following order: 


e Previously defined macro names 


e User-defined opcode (see the .OPDEF description in Chapter 5) 
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e Permanent symbols (instructions and directives) 
e Macro libraries 


This search order allows permanent symbols to be redefined as _ macro 
names. If a symbol in the operator field is not defined as a macro or 
a permanent symbol, the assembler displays an error message. 


A symbol in the operand field must be either a user-defined symbol or 
a register name. 


User-defined symbols can be either local (internal) symbols or global 
(external) symbols. Whether symbols are local or global depends on 
their use in the source program. 


A local symbol can be referenced only in the module in which it is 
defined. If local symbols with the same names are defined in 
different modules, the symbols are completely independent. A global 
symbol's definition, however, can be referenced from any module in the 
program. 


Normally, VAX-11 MACRO treats all user-defined symbols as local when 
they are defined. However, a symbol definition can be explicitly 
declared to be global by any one of the following three methods: 


e Use of the double colon (::) in defining a label (see Section 
2.1) 


e Use of the double equal sign (==) in a direct assignment 
statement (see Section 3.8) 


e Use of the .GLOBAL, .ENTRY, or .WEAK directive (see Chapter 5) 


When a symbol is referenced within the module in which it is defined, 
VAX-11 MACRO considers’ the reference an internal reference. When a 
symbol is referenced within a module in which it is not defined, 
VAX-11 MACRO considers the reference an external reference (that is, 
the symbol is defined in another module). The .DISABLE directive can 
be used to make references to symbols not defined in the current 
module illegal. In this case, the .EXTERNAL directive must be used to 
specify that the reference is an external reference. See Chapter 5 
for descriptions of the .DISABLE and .EXTERNAL directives. 


3.4 LOCAL LABELS 


Local labels are used to identify addresses within a block of source 
code. 


Format 
nns 


nn 
A decimal integer in the range of 1 through 65535. 


Local labels can be used in the same way as _ user-defined symbol 
labels, but with the following differences: 


e Local labels cannot be referenced outside the block of source 
code in which they appear. 


e Local labels can be reused in another block of source code. 
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e Local labels do not appear in the symbol tables and, thus, 
cannot be accessed by the debugger. 


e Local labels cannot be used in .END (see Chapter 5). 


By convention, local labels are positioned like statement labels: 
left-justified in the source text. Although local labels can appear 
in the program in any order, by convention, the local labels in any 
block of source code should be in numeric order. 


Local labels are useful as branch addresses when the address is’ used 
only within the block. Local labels can _ be used to distinguish 
between addresses that are referenced only in a small block of code 
and addresses that are referenced elsewhere in the module. A 
disadvantage of local labels is that their numeric names’~ cannot 
provide any indication of their purpose. Consequently, local labels 
should not be used to label sequences of statements that are logically 
unrelated; user-defined symbols should be used instead. 


DIGITAL recommends that users create local labels only in the range of 
1$ to 29999S because the assembler automatically creates local labels 
in the range of 30000S to 65535$ for use in macros (see Section 
6.1.6). 


The local label block in which a local label is valid is delimited by 
the following statements: 


e A user-defined label 
e A .PSECT directive (See Chapter 5) 


e The .ENABLE and .DISABLE directives (see Chapter 5) which can 
extend a local label block beyond user-defined labels and 
»~PSECT directives 


A local label block is usually delimited by two user-defined labels. 
However, the .ENABLE LOCAL BLOCK directive starts a local block that 
is terminated only by one of the following: 


e A second .ENABLE LOCAL BLOCK directive 


e A .DISABLE LOCAL BLOCK directive followed by a _ user-defined 
label or a .PSECT directive 


Although local label blocks can extend from one program section to 
another, DIGITAL recommends that local labels in one program section 
not be referenced from another program section. User-defined symbols 
should be used instead. 


Local labels can be preserved for future reference with the context of 
the program section in which they are defined; see the descriptions 
of the .SAVE PSECT [LOCAL BLOCK] directive and _ the »RESTORE_ PSECT 
directive in Chapter 5. — 


An example showing the use of local labels follows. 


AMOUNT ,RO 
DELTA,RO 
10$ 
DELTA,RO 
MAX,R1 
R2 

RO,R1 
20$ 
INCR,RO 
R2 

10$ 
R2,COUNT 
TEST 


LOCAL BLOCK 
#°“M<RO,R1,R2> 
RO,R1,R3 

10$ 


R2,R3 
R2,R3 
20$ 
RO 
NEXT 


RO 


-DISABLE LOCAL BLOCK 


RPSUB: MOVL 
108: SUBL2 
BGTR 
ADDL2 
COMP: MOVL 
-CLRL 
108: CMPL 
BGTR 
SUBL 
INCL 
BRB 
208: MOVL 
BRW 
.» ENABLE 
ENTR1: POPR 
ADDL3 
BRB 
ENTR2: SUBL2 
108: SUBL2 
BGTR 
INCL 
BRB 
20S: DECL 
NEXT: CLRL 
35 5 


R4 


TERMS AND EXPRESSIONS 
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STARTS LOCAL LABEL BLOCK 

DEFINE LOCAL LABEL 10$ 
CONDITIONAL BRANCH TO LOCAL LABEL 
EXECUTED WHEN RO NOT > 0 

ENDS PREVIOUS LOCAL LABEL 

BLOCK AND STARTS NEW ONE 

DEFINE NEW LOCAL LABEL 10$ 
CONDITIONAL BRANCH TO LOCAL LABEL 
EXECUTED WHEN RO NOT > R1 


UNCONDITIONAL BRANCH TO LOCAL LABEL 
DEFINE LOCAL LABEL 

UNCONDITIONAL BRANCH TO 
USER-DEFINED LABEL 

START LOCAL LABEL BLOCK 

THAT WILL NOT BE TERMINATED 

BY A USER-DEFINED LABEL 

BRANCH TO LOCAL LABEL THAT IS AFTER 
A USER-DEFINED LABEL 

DOES NOT START A NEW 

LOCAL LABEL BLOCK 

DEFINE LOCAL LABEL 

CONDITIONAL BRANCH TO LOCAL LABEL 
EXECUTED WHEN R2 NOT > R3 
UNCONDITIONAL BRANCH TO 
USER-DEFINED LABEL 

DEFINE LOCAL LABEL 

DIRECTIVE FOLLOWED 

BY USER-DEFINED LABEL TERMINATES 
LOCAL LABEL BLOCK 


A term can be any one of the following: 


e A number 


e A symbol 


e The current location counter (see Section 3.9) 


e A textual operator followed by text (see Section 3.4.2) 


@e Any of the above preceded by a 


3.6) 


VAX-11 MACRO evaluates terms 


undefined 
value. 


symbol 


is used as a term, 
The current location counter (.) has the value of the location 


unary operator (see Section 


longword (4-byte) values. If an 


the linker determines the term's 


counter at the start of the current operand. 


Expressions are combinations of terms joined by binary operators 
3.7) and evaluated as longword 
evaluates expressions from left to right with no 
angle brackets (<>) can be used to change the order 
Any part of an expression that is 
first evaluated to a single value, which is then used in 
expression. 
and A*<B+C> are different. 
apply a unary operator to an entire expression, 


Section 
rules. 


brackets is 


evaluating the complete 


A*B+C 


Note that unary operators are considered part of a term; 
MACRO performs 


However, 
of evaluation. 


the action 


(see 
(4-—byte) values. VAX-11 MACRO 
operator precedence 


enclosed in angle 

For example, the expressions 
Angle brackets can also be used to 
such as -<A+B>. 


thus, VAX-ll 


indicated by a unary operator before it 


performs the action indicated by any binary operator. 


ae ae 
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Expressions fall into three categories: 
external (global). 


e An expression is relocatable if i 
the start of the program sect 
current location counter is re 
program section, 


e An expression is absolute if its 
constant. An expression whose 
absolute. An expression that con 
minuS another’ relocatable term 
is absolute, because such an 
assembly-time constant. 


relocatable, absolute, and 


ts value is fixed relative to 
ion in which it appears. The 
locatable in ae relocatable 


value is an assembly-time 
terms are all numbers is 
sists of a relocatable term 
from the same program section 
expresSion reduces’ to an 


e An expression is external if it contains one or more _ symbols 


that are not defined in the curre 


Any type of expression can be used in 
restrictions are placed on expressions us 


e .ALIGN alignment directive 


nt module. 


most macro statements, but 
ed in: 


e .BLKx storage allocation directives 


e .IF and .IIF conditional assembly block directives 


e .REPEAT repeat block directive 


e .OPDEF opcode definition directive 


e .ENTRY entry point directive 


e .BYTE, .LONG, .WORD, .SIGNED_ BYTE, and .SIGNED WORD directive 


repetition factors 
e Direct assignment statements (see 


See Chapter 5 for descriptions of the dir 
-REPEAT which is described in Chapter 
directives and in direct assignment s 
symbols that have been previously defined 


Section 3.8) 


ectives listed above, except 
6. Expressions used in these 
tatements can only contain 

in the current module. They 


cannot contain either external symbols or symbols defined later in the 


current module. In addition, the express 


ions in these directives must 


be absolute. Expressions in direct assignment statements can _ be 


relocatable. 
An example showing the use of expressions 
A = 2*100 

-BLKB A+50 


LAB: - BLKW A 
HALF = LAB+<A/2> 


LAB2: -BLKB LAB2~LAB 


- WORD LAB3-LAB2 


LAB3: -WORD TST+LAB+2 


CY et eT ee, Y ee) eT ee ee ee eT er TT 


follows. 


2*100 IS AN ABSOLUTE EXPRESSION 
A+50 IS AN ABSOLUTE EXPRESSION AND 
CONTAINS NO UNDEFINED SYMBOLS 

LAB IS RELOCATABLE 

LAB+<A/2> IS A RELOCATABLE 
EXPRESSION AND CONTAINS NO 
UNDEFINED SYMBOLS 

LAB2-LAB IS AN ABSOLUTE EXPRESSION 
AND CONTAINS NO UNDEFINED SYMBOLS 
LAB3-LAB2 IS AN ABSOLUTE EXPRESSIO 
BUT CONTAINS THE SYMBOL LAB3 

THAT IS DEFINED LATER IN THIS MODU 
TST+LAB+2 IS AN EXTERNAL EXPRESSIO 
BECAUSE TST IS AN EXTERNAL SYMBOL 
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3.6 UNARY OPERATORS 


A unary operator modifies a term or an expression, 
be performed on 
modified by unary operators must be enclosed in angle brackets. 
can be 
positive or negative (if unary plus or minus 


action to 


operators 


that term 


used to 


or expression. 


and indicates 


is not 


value is assumed to be plus, by default). In addition, unary 
operators perform radix conversion, textual conversion (including 
ASCII conversion), and numeric control operations, as described in 
Sections 3.6.1 through 3.6.3. Table 3-3 summarizes’ the unary 
operators. 

Table 3-3 


Unary 
Operator 


Unary Operators 


Operator Name 


Plus sign 


Minus sign 


Binary “B11000111 


Decimal “Di27 
Octal 


Hexadecimal 


ASCII 


Register mask #°M<R3,R4,R5> 


Floating point 


Complement 


Operation 


Results in the positive 
value of A 


Results in the negative 
(2's complement) value 
of A 


Specifies that 11000111 
is a binary number 


Specifies that 127 is a 
decimal number 


Specifies that 34 is an 
octal number 


Specifies that FCF9 is 
a hexadecimal number 


Produces an ASCII 
String; the characters 
between the matching 
delimiters are 
converted to ASCII 
representation 


Specifies the registers 
R3, R4, and R5 in the 
register mask 


Specifies that 3.0 is a 
floating-point number 


Produces the l's 
complement value of 24 
(decimal) 





Expressions 
Unary 
indicate whether a term or expression is 
specified, the 
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More than one unary operator can be applied to a single term or to an 
expression enclosed in angle brackets. For example: 
-+-A 
This construct is equivalent to: 


—<+<-A>> 


3.6.1 Radix Control Operators 


VAX-11 MACRO accepts terms or expressions in four different radixes: 
binary, decimal, octal, and hexadecimal. The default radix is 
decimal. Expressions modified by radix control operators must be 
enclosed in angle brackets. 


Formats 
“Bnn 
“Dnn 
“Onn 
“Xnn 
nn 


A string of characters that are legal in the specified radix. 
The legal characters for each radix are listed below. 


Format Radix Name Legal Characters 

*Bnn Binary 0 and 1 

“Dnn Decimal 0 through 9 

“Onn Octal 0 through 7 

“Xnn Hexadecimal 0 through 9 and A through F 


Radix control operators can be included in the source program anywhere 
a numeric value is legal. A radix control operator affects only the 
term or expression immediately following it, causing that term or 
expression to be evaluated in the specified radix. 


For example: 


- WORD *B00001101 

-WORD “D123 

- WORD “047 

- WORD <A+*013> 

- LONG “X<F1C3+FFFFF-20> 


BINARY RADIX 

DECIMAL RADIX (DEFAULT) 
OCTAL RADIX 

13 IS IN OCTAL RADIX 

ALL NUMBERS IN EXPRESSION 
ARE IN HEXADECIMAL RADIX 


me Te Me Se Te VW 


The circumflex cannot be separated from the B, D, O, or X that follows 
it, but the entire radix control operator can be separated by spaces 
and tabs from the term or expression that is to be evaluated in that 
radix. 


The decimal operator, the default, is needed only within an expression 
that has another radix control operator. In the following example, 
the 16 would be interpreted as an octal number if the “D operator did 
not precede it: 


- LONG “0<10000 + 100 + “D16> 
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3.6.2 Textual Operators 


The textual operators are the ASCII operator (A) and the register 
mask operator (M). 


3.6.2.1 ASCII Operator - The ASCII operator converts a string of 
printable characters to their 8-bit ASCII values and stores them one 
character to a byte. The string of characters must be enclosed in a 
pair of matching delimiters. 


The delimiters can be any printable character except the space, tab, 
or semicolon (;). Although alphanumeric characters can be used as 
delimiters, nonalphanumeric characters should be used _ to avoid 
confusion. 


Format 
“Astring 


string 
A delimited ASCII string from 1 through 16 characters long. 


The delimited ASCII string must not be larger than the data type of 
the operand. For example, if the “A operator occurs in an operand in 
a MOVW instruction (the data type is a word), the delimited string 
cannot be more than two characters. 
For example: 

MOVL #“A/ABCD/,RO MOVES CHARACTERS A,B,C,D 
INTO RO RIGHT JUSTIFIED WITH 
"A" IN LOW-ORDER BYTE AND "D" 
IN HIGH-ORDER BYTE 
COMPARES X AND Y AS ASCII 
CHARACTERS WITH CONTENTS OF LOW 
ORDER 2 BYTES OF RO 
GENERATES 8 BYTES OF ASCII DATA 
MOVE ASCII CHARACTERS AB INTO 
RO; "A" IN LOW-ORDER BYTE; "B" 
IN NEXT; AND ZERO THE 2 HIGH- 
ORDER BYTES 


CMPW #°A/XY/,RO 


-QUAD “A%1234/678% 
MOVL #°A/AB/,RO 


me ™e Se Ne MO Me MO NO MO NO WH NE 


3.6.2.2 Register Mask Operator - The register mask operator converts 
a register name or a list of register names enclosed in angle brackets 
into a l- or 2-byte register mask. The register mask is used by the 
PUSHR and POPR instructions and the .ENTRY and .MASK directives (see 
Chapter 5). 


Formats 


“Mreg-name 
“M<reg-name-list> 


reg-name 
One of the register names or the DV or IV arithmetic trap enable 
specifiers. 


reg-name-list 
A list of register names and/or the DV and IV arithmetic’ trap 
enable specifiers, separated by commas. 
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The register mask operator sets a bit in the register mask for every 
register name or arithmetic trap enable specified in the list. The 
bits corresponding to each register name and arithmetic trap enable 
specifier are listed below. 


Register Name Arithmetic Trap Bits 
Enable 
RO through Rll 0 through 11 (respectively) 
R12 or AP 12 
FP 13 
SP IV 14 
DV 15 


When the register mask operator is used in a POPR or PUSHR 
instruction, RO through Rll, R12 or AP, FP, and SP can be specified. 
The PC register name and the IV and DV arithmetic trap enable 
specifiers cannot be specified. 


When the register mask operator is used in the .ENTRY or  .MASK 
directives, R2 through R11 and the IV and DV arithmetic trap enable 
specifiers can be specified. However, RO, Rl, FP, SP, and PC’ cannot 
be specified. Iv sets the integer overflow trap, and DV sets the 
decimal string overflow trap. 


See the VAX-11 Architecture Handbook for more information on register 
masks and arithmetic trap enable specifiers. 
For example: 

-ENTRY RT1,°M<R3,R4,R5,R6,IV> SAVE REGISTERS R3,R4 
R5, AND R6 AND SET THE 
INTEGER OVERFLOW TRAP 
SAVE REGISTERS RO,RI1, 


R2, AND R3 ; 
RESTORE RO,R1,R2, AND R3 


PUSHR #°M<RO,R1,R2,R3> 


me “eo Se “Se NS SS 


POPR #°M<RO,R1,R2,R3> 


3.6.3 Numeric Control Operators 


The numeric control operators are the floating-point operator (“F) and 
the complement operator (“C). 


3.6.3.1 Floating-Point Operator - The floating-point operator accepts 
a floating-point number and converts it to its internal representation 
(a 4-byte value). This value can be used in any expression. VAX-11 
MACRO does not perform floating-point expression evaluation. 


Format 
“Fliteral 


literal 
A floating-point number (see Section 3.2.2). 


The floating-point operator is useful because it allows a 
floating-point number in an instruction that accepts integers. 
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For example: 


NOTE THE RECOMMENDED INSTRUCTION 
TO MOVE THIS FLOATING-POINT NUMBER 
IS THE MOVF INSTRUCTION 


MOVL #°F3.7,RO0 


~e *e Me 


MOVE #3.7,R0 


3.6.3.2 Complement Operator - The complement operator produces’7 the 
1's complement of the specified value. 


Format 
“Cterm 
term 
Any term or expression. If an expression is specified, it must 


be enclosed in angle brackets. 


VAX-11 MACRO evaluates the term or expression as a 4-byte value before 
complementing it. 


For example: 


~ LONG “C*XFF 
.~ LONG “C25 


PRODUCES FFFFFFOO (HEX) 
PRODUCES COMPLEMENT OF 
25 (DEC) WHICH IS 
FFFFFFE6 (HEX) 


=e “eo MO MO 


3.7 BINARY OPERATORS 
In contrast to unary operators, binary operators specify actions to be 


performed on two terms or expressions. Expressions must be enclosed 
in angle brackets. Table 3-4 summarizes the binary operators. 


Table 3-4 
Binary Operators 


Binary 

Operator Operator Name Example Operation 
Plus sign Addition 
Minus sign Subtraction 
Asterisk Multiplication 


Slash Division 


At sign Arithmetic shift 


Ampersand Logical AND 
Exclamation point Logical inclusive OR 


Backslash Logical exclusive OR 
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All binary operators have equal priority. Terms or expressions can be 
grouped for evaluation by enclosing them in angle brackets. The 
enclosed terms and expressions are then evaluated first, and remaining 
operations are performed from left to right. For example: 


- LONG 1+2*3 ; EQUALS 9 
- LONG 1+<2*3> ; EQUALS 7 
Note that a 4-byte result is returned from all binary operations. If 


a 1l-byte or 2~-byte operand is used, the result is the low-order 
byte(s) of the 4-byte result. VAX-11 MACRO displays an error message 
if the truncation causes a loss of significance. 


The’ following sections describe the arithmetic shift, logical AND, 
logical inclusive OR, and logical exclusive OR operators in more 
detail. 


3.7.1 Arithmetic Shift Operator 


The arithmetic shift operator (@) is used to perform left and right 
arithmetic shift of arithmetic quantities. The first argument is 
shifted left or right the number of bit positions specified by the 
second argument. If the second argument is positive, the first 
argument is shifted left; if the second argument is negative, the 
first argument is shifted right. When the first argument is shifted 
left, the low-order bits are set to 0; and when the first argument is 
shifted right, the high-order bits are set to the value of the 
original high-order bit (the sign bit). 


For example: 
- LONG “B101@4 YIELDS 1010000 (BINARY) 


; 
.~ LONG 1@2 : YIELDS 100 (BINARY) 
MOVL #<*B1100000@-5>,RO0 ; YIELDS 11 (BINARY) 


- LONG 1@A 
- LONG “X1234@-A 


YIELDS 10000 (BINARY) 
YIELDS 123 (HEX) 


me me 


3.7.2 Logical AND Operator 
The logical AND operator (&) takes the logical AND of two operands. 


For example: 


A = “B1010 
B = “B1100 
- LONG A&B 7 YIELDS 1000 (BINARY) 
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3.7.3 Logical Inclusive OR Operator 


The logical inclusive OR operator (!) takes the logical inclusive OR 
of two operands. 


For example: 


A = “B1010 
B = “B1100 
- LONG A!B ; YIELDS 1110 (BINARY) 


3.7.4 Logical Exclusive OR Operator 


The logical exclusive OR operator (\) takes the logical exclusive OR 
of two arguments. 


For example: 
“B1010 


*B1100 
~-LONG A\B 


A 
B 


; YIELDS 0110 (BINARY) 


3.8 DIRECT ASSIGNMENT STATEMENTS 


A direct assignment statement equates a symbol to a specific value. 
Unlike a symbol that is used as a label, a symbol defined with a 
direct assignment statement can be redefined as many times as desired. 


Formats 


symbol=expression 
symbol==expression 


symbol 
A user-defined symbol. 


expression 
An expression that does not contain any undefined symbols (see 
Section 3.5). 


The format with a single equal sign (=) defines a local symbol and the 
format with a double equal sign (==) defines a global symbol. See 
Section 3.3.3 for more information about local and global symbols. 


The following three syntactic rules apply to direct assignment 
statements: 


e An equal sign (=) or double equal sign (==) must separate the 
symbol from the expression defining the symbol's’ value. 
Spaces preceding and/or following the direct assignment 
operators have no Significance in the resulting value. 


e Only one symbol can be defined in a single direct assignment 
statement. 


e A direct assignment statement can be followed only by a 
comment field. 


THE COMPONENTS OF MACRO SOURCE STATEMENTS 
In addition, by DIGITAL convention, the symbol in a direct assignment 
Statement is placed in the label field. 


For example: 


TO 1270 (DEC) 
THE SYMBOL 'D' IS EQUATED 
TO 10 (HEX) 


D = *X100/*X10 


A== 1 ; THE SYMBOL 'A' IS GLOBALLY 
; EQUATED TO THE VALUE 1 

B = A@5 ; THE SYMBOL 'B' IS EQUATED 
+ TO 1@5 OR 20 (HEX) 

C = 127*10 ; THE SYMBOL 'C' IS EQUATED 
; 
; 
; 


3.9 CURRENT LOCATION COUNTER 


The period (.), the symbol for the current location counter, always 
has the value of the address of the current byte. VAX-11 MACRO sets 
the current location counter to 0 at the beginning of the assembly and 
at the beginning of each new program section. 


Every VAX-11 MACRO source statement that allocates memory in_ the 
object module increments the value of the current location counter by 
the number of bytes allocated. For example, the directive .LONG 0 
increments the current location counter by 4. However, a direct 
assignment statement, except the special form described below, does 
not increaSe the current location counter because no memory is 
allocated. 


The current location counter can be explicitly set by a special form 
of the direct assignment statement. The location counter can be 
either incremented or decremented. Explicitly. setting the location 
counter is often useful when defining data structures. Data storage 
areas should not be reserved by explicitly setting the location 
counter; the .BLKx directives should be used instead (see Chapter 5). 


Format 
-=expression 
expression 
An expression that does not contain any undefined symbols (see 
Section 3.5). 
In a relocatable program section, the expression must be relocatable; 
that is, the expression must be relative to an address in the current 
program section. It can be relative to the current location counter. 
For example: 


- = .+40 MOVES LOCATION COUNTER 


FORWARD 


me Se 


When a program section previously defined in the current module is 
continued, the current location counter is set to the last value of 
the current location counter in that program section. 


When the current location counter is used in the operand field of an 
instruction, the current location counter has the value of the address 
of that operand--it does not have the value of the address of the 
beginning of the instruction. For this reason, the current location 
counter is not normally used as a part of the operand specifier. 


CHAPTER 4 


ADDRESSING MODES 


This chapter summarizes the VAX-1l1 addressing modes and _ contains 
examples of VAX-11 MACRO statements that use these addressing modes. 
The VAX-11 Architecture Handbook describes the addressing modes’ in 
detail. 
There are four types of addressing modes: 

e General Register 

@® Program Counter 

e Index 

e Branch 
Although index mode is a general register mode, it is considered a 
Separate type of mode because it can be used only in combination with 


another type of mode. 


Table 4-1 summarizes the addressing modes. 


4.1 GENERAL REGISTER MODES 


The general register modes use registers RO through R12, AP (the’ same 
as R12), FP, and SP. 


There are eight general register modes: 
e Register 
e Register Deferred 
e Autoincrement 
e Autoincrement Deferred 
e Autodecrement 
e Displacement 
e Displacement Deferred 


e Literal 


Type 


General 
Register 


General 
Register 
(Cont. ) 


Program 
Counter 


Addressing 
Mode 


Register 


Register 
Deferred 


Autoincrement 


Autoincrement 
Deferred 


Autodecrement 


Displacement 


Displacement 
Deferred 


Literal 


Relative 


Relative 
Deferred 


Absolute 


Immediate 


General 





ADDRESSING MODES 


Table 4-1 


Addressing Modes 


(Rn) 


(Rn) + 


@(Rn) + 


- (Rn) 


dis (Rn) 

B“dis (Rn) 
W“dis (Rn) 
L*dis(Rn) 


@dis (Rn) 

@B“dis (Rn) 
@w°dis (Rn) 
@L“dis (Rn) 


#literal 
S*#literal 


address 

B* address 
Waddress 
L*address 


@address 

@B“address 
@W° address 
@L“address 


@#address 


#literal 
I*#literal 


G* address 















Hexa- 
decimal 


Value Description 





Register contains the operand 


Register contains the address of 
the operand 


Register contains the address of the 
operand; the processor 
increments the register contents 
by the size of the operand data 
type 


Register contains the address of 
the operand address; the 
processor increments the 
register contents by 4 


The processor decrements the 
register contents by the size 
of the operand data type; the 
register then contains the 
address of the operand 


The sum of the contents of the 
register and the displacement is 
the address of the operand; B*, 
w*,and L* indicate byte, word, 
and longword displacement, 
respectively 


mY 


The sum of the contents of the 
register and the displacement is 
the address of the operand 
address; B”, W, and L”® 
indicate byte, word, and 
longword displacement, 
respectively 


mo oO 


The literal specified is the 
the operand; the literal is 
stored as a short literal 


The address specified is the Yes 
address of the operand; the 
address specified is stored as a 
displacement from PC; B*, W*, 
and L* indicate byte, word, and 
longword displacement, 
respectively 


moa Y 


The address specified is the address 
of the operand address; the address 
specified is stored as a 
displacement from PC; B*, W*, 
and L* indicate byte, word, and 
longword displacement, 
respectively 


moO Ow 


The address specified is the address 
of the operand; the address 
specified is stored as an 
absolute virtual address (not as 
a displacement) 


The literal specified is the 
operand; the literal is stored 
as a byte, word, longword, or 
quadword 


The address specified is the 
address of the operand;; if the 
address is defined as 
relocatable, the linker stores 
the address as a displacement 
from PC; if the address is 
defined as an absolute virtual 
address, the linker stores the 
address as an absolute value 









Indexable? 


No 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


No 


Yes 


Yes 


No 


Yes 


(continued on next page) 


ADDRESSING MODES 


Table 4-1 (Cont.) 
Addressing Modes 


Addressing 
Mode Format* Description Indexable? 


base-mode [Rx] The base-mode specifies the base 
address and the register 
specifies the index; the sum of 
the base address and the product 
of the contents of Rx and the 


size of the operand data type is 
the address of the operand; 
base-mode can be any addressing 
mode except register, immediate, 
literal, index, or branch 


Branch address The address specified is the 
operand; this address is stored 
as a displacement to PC; branch 
mode can only be used with the 
branch instructions 





* Key: 


Rn 
Any general register RO through R12. Note that the AP, FP, or SP 
register can be used in place of Rn. 


Rx 
Any general register RO through R12. Note that the AP, FP, or SP 
register can be used in place of Rx. Rx cannot be the same as the Rn 
specified in the base-mode for certain base modes(see Section4.3). 
dis 
An expression specifying a displacement. ;: 
address 
An expression specifying an address. 
literal 


An expression, an integer constant, or a floating-point constant. 


ADDRESSING MODES 


4.1.1 Register Mode 


In register mode, the operand is the contents of the specified 
register, except in the following cases: 


e For quadword, D floating, G floating or variable-bit field 
operands, the operand is the contents of register n 
concatenated with the contents of register n+l. 


e For octaword and H_ floating operands, the operand is the 
contents of register n concatenated with the contents of 
registers n+l, n+2, and n+3. 


In each of these cases, the least significant bytes of the operand are 
in register n and the most’ significant bytes are in the highest 
register used, either n+l or n+3. 


The results of the operation are unpredictable if PC is used in 
register mode or if the use of a large data type extends the operand 
into the PC. 


Formats 
Rn 
AP 
FP 
SP 
n 


A number in the range of 0 through 12. 


Example 
CLRB RO ; CLEAR LOWEST BYTE OF RO 
CLRQ Rl ; CLEAR R1 AND R2 
TSTW R10 ; TEST LOWER WORD OF R1O 
INCL R4 ; ADD 1 TO R4 


4.1.2 Register Deferred Mode 


In register deferred mode, the register contains the address of the 
operand. Register deferred mode can be used with index mode (see 
Section 4.3). 


Formats 
(Rn) 
(AP) 
(FP) 
(SP) 
n 


A number in the range of 0 through 12. 
Example 


MOVAL LDATA,R3 MOVE ADDRESS OF LDATA TO R3 


‘ 
CMPL (R3) ,RO ; COMPARE VALUE AT LDATA TO RO 
BEQL 10$ ; IF THEY ARE THE SAME, IGNORE 
CLRL (R3) ; CLEAR LONGWORD AT LDATA 
10S: MOVL (SP) ,R1 7 COPY TOP ITEM OF STACK INTO Rl 
’ 


MOVZBL_ (AP) ,R4 GET NUMBER OF ARGUMENTS IN CALL 


ADDRESSING MODES 


4.1.3 Autoincrement Mode 


In autoincrement mode, the register contains the address of the 
operand. After evaluating the operand address contained in the 
register, -the processor increments that address by the size of the 
operand data _ type. The processor increments’ the contents of the 
register by 1, 2, 4, 8, or 16 for a byte, word, longword, quadword, or 
octaword operand, respectively. 


Autoincrement mode can be used with index mode (see Section 4.3), but 
the index register cannot’ be the same as the register specified in 
autoincrement mode. 


Formats 
(Rn) + 
(AP) + 
(FP) + 
(SP) + 

n 


A number in the range of 0 through 12. 
Example 
MOVAL TABLE,R1 


CLRQ (R1)+ 
CLRL (R1)+ 


GET ADDRESS OF TABLE 

CLEAR FIRST AND SECOND LONGWORDS 
AND THIRD LONGWORD IN TABLE 
LEAVE Rl POINTING TO TABLE +12 
GET ADDRESS OF BYTARR 

INCREMENT FIRST BYTE OF BYTARR 
AND SECOND 

7 EXCLUSIVE-OR THE TWO LONGWORDS 
WHOSE ADDRESSES ARE STORED IN 

R3 AND R4 AND STORE RESULT IN 
ADDRESS CONTAINED IN R5, THEN 
ADD 4 TO R3, R4, AND R5 


MOVAB  BYTARR,R2 

INCB (R2)+ 

INCB (R2)+ 

XORL3. = (R3) +, (R4) +, (R5) 


me Me Ne Ne af Se Me Ne Ne Ne Ne Ne 


4.1.4 Autoincrement Deferred Mode 


In autoincrement deferred mode, the register contains an address’ that 
is the address of the operand address (a pointer to the operand). 
After evaluating the operand address, the processor increments’ the 
contents of the register by 4 (the size in bytes of an address). 


Autoincrement deferred mode can be used with index mode (see Section 
4.3), but the index register cannot be the same as the register 
specified in autoincrement deferred mode. 


Formats 
@(Rn)+ 
@(AP)+ 
@(FP)+ 
@(SP)+ 

n 


A number in the range of 0 through 12. 


ADDRESSING MODES 


Example 


MOVAL PNTLIS,R2 
CLRQ @(R2)+ 


GET ADDRESS OF POINTER LIST 
CLEAR QUADWORD POINTED TO BY . 
FIRST ABSOLUTE ADDRESS IN PNTLIS. 
THEN ADD 4 TO R2 


CLRB @(R2)+ CLEAR BYTE POINTED TO BY SECOND 
ABSOLUTE ADDRESS IN PNTLIS 
THEN ADD 4 TO R2 

MOVL R10,@(RO)+ MOVE R10 TO LOCATION WHOSE ADDRESS 


IS POINTED TO BY RO; THEN ADD 4 
TO RO 


me we we we Te NO Me MO NO Me 


4.1.5 Autodecrement Mode 


In autodecrement mode, the processor decrements the contents of the 
register by the size of the operand data type; then the register 
contains the address of the operand. The processor decrements’~ the 
register by 1, 2, 4, 8, or 16 for byte, word, longword, quadword, or 
octaword operands, respectively. 


Autodecrement mode can be used with index mode (see Section 4.3), but 
the index register cannot be the same as the register specified in 
autodecrement mode. 


Formats 


- (Rn) 
- (AP) 
- (FP) 
- (SP) 


A number in the range of 0 through 12. 

Example 
CLRO -(R1) SUBTRACT 8 FROM Rl AND ZERO THE 

OCTAWORD WHOSE ADDRESS IS THEN 
IN Rl 
PUSH THE ZERO-EXTENDED LOW BYTE 
OF R3 ONTO THE STACK AS A LONGWORD 
ONTO THE STACK 
SUBTRACT 1 FROM RO AND COMPARE LOW 
BYTE OF Rl WITH BYTE WHOSE ADDRESS 
IS NOW IN RO 


MOVZBL R3,-(SP) 


CMPB R1,-(RO) 


=e es te Me Ne Se Ms NS MO 


4.1.6 Displacement Mode 

In displacement mode, the sum of the contents of the register and the 
displacement (sign extended to a longword) is the address of the 
operand. 


Displacement mode can be used with index mode (see Section 4.3). 


ADDRESSING MODES 


Formats 


dis (Rn) 
dis (AP) 
dis (FP) 
dis(SP) 


A number in the range of 0 through 12. 


dis 
An expresSion specifying a displacement; the expression can be 
preceded by one of the following displacement length specifiers, 
which indicate the number of bytes needed to store the 
displacement. 
Displacement 
Length Specifier Meaning 
B~ Displacement requires 1 byte 
w* Displacement requires 1 word (2 bytes) 
EL” _ Displacement requires 1 longword (4 bytes) 
If no displacement length specified precedes the expression and 
the value of the expression is known, the assembler chooses the 
smallest number of bytes (1, 2, or 4) needed to store the 
displacement. If no length specifier precedes the expression and 
the value of the expression is unknown, the assembler reserves 1 
word (2 bytes) for the displacement. Note that if the 
displacement is either relocatable or defined later in the source 
program, the assembler considers it unknown. If the actual 
displacement does not fit in the memory reserved, the linker 
displays an error message. 
Example 
MOVAB KEYWORDS ,R3 ; GET ADDRESS OF KEYWORDS 
MOVB B“IO(R3) ,R4 ; GET BYTE WHOSE ADDRESS IS 
; IO PLUS ADDRESS OF KEYWORDS 
7; THE DISPLACEMENT IS STORED AS A BYTE 
MOVB B“ACCOUNT(R3),R5; GET BYTE WHOSE ADDRESS IS ACCOUNT 
; PLUS ADDRESS OF KEYWORDS 
; THE DISPLACEMENT IS STORED AS A BYTE 
CLRW L“STA(R1) ; CLEAR WORD WHOSE ADDRESS 
; IS STA PLUS CONTENTS OF RI 
; THE DISPLACEMENT IS STORED 
; AS A LONGWORD 
MOVL RO ,-2(R2) 7; MOVE RO TO ADDRESS THAT IS -2 
; PLUS THE CONTENTS OF R2 
; THE DISPLACEMENT IS STORED AS A BYTE 
TSTB EXTRN (R3) ; TEST THE BYTE WHOSE ADDRESS 
; IS EXTRN PLUS THE 
; ADDRESS OF KEYWORDS 
; THE DISPLACEMENT IS STORED AS A WORD 
; SINCE EXTRN IS UNDEFINED 
MOVAB 2(R5),RO 3; MOVE <CONTENTS OF R5> + 2 
; TO RO 
Note 


If the value of the displacement is 0 and no displacement length 
is specified, the assembler uses register deferred mode rather 
than displacement mode. 


ADDRESSING MODES 


4.1.7 Displacement Deferred Mode 


In displacement deferred mode, the sum of the contents of the register 
and the displacement (sign extended to a longword) is the address of 
the operand address (a pointer to the operand). 


Displacement deferred mode can be used with index mode (see Section 
4,3) % 


Formats 
@dis (Rn) 
@dis (AP) 
@dis (FP) 
@dis (SP) 
n 


A number in the range of 0 through 12. 


dis 
An expression specifying a displacement; the expression can be 
preceded by one of the following displacement length specifiers, 
which indicate the number of bytes needed to store the 
displacement. 


Displacement 
Length Specifier Meaning 
B* Displacement requires 1 byte 
w* Displacement requires 1 word (2 bytes) 
L* Displacement requires 1 longword (4 bytes) 


If no displacement length specifier precedes the expression and 
the value of the expression is known, the assembler chooses the 
smallest number of bytes (1, 2, or 4) needed to store the 
displacement. If no length specifier precedes the expression and 
the value of the expression is unknown, the assembler reserves 1 
word (2 bytes) for the displacement. Note that if the 
displacement is either relocatable or defined later in the source 
program, the assembler considers it unknown. If the actual 
displacement does not fit in the memory reserved, the _ linker 
displays an error message. 


Example 


GET ADDRESS OF ARRAY OF POINTERS 

CLEAR LONGWORD POINTED TO BY 

LONGWORD WHOSE ADDRESS IS 16 

PLUS THE ADDRESS OF ARRPOINT 

THE DISPLACEMENT IS STORED AS A BYTE 

MOVL @B“OFFS(R6), @RSOFF (R6) ; MOVE THE LONGWORD POINTED TO 

BY LONGWORD WHOSE ADDRESS IS 

OFFS PLUS THE ADDRESS OF ARRPOINT 

TO THE ADDRESS POINTED TO BY 

LONGWORD WHOSE ADDRESS IS 

RSOFFS PLUS THE ADDRESS OF ARRPOINT 

THE FIRST DISPLACEMENT IS STORED AS A BYTE 
THE SECOND DISPLACEMENT IS STORED AS A WOF 
CLEAR THE WORD THAT IS POINTED 

TO BY LONGWORD AT 84 PLUS THE 

CONTENTS OF R2--THE ASSEMBLER USES 

BYTE DISPLACEMENT AUTOMATICALLY 


MOVAL ARRPOINT,R6 
CLRL @16 (R6) 


=e “oe we NO 


CLRW @84 (R2) 
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4.1.8 Literal Mode 


In literal mode, the value of the literal is stored in the addressing 


mode byte itself. 
Formats 


#literal 
S*#literal 


literal 


An expression, an integer constant, or a floating-point constant. 
The literal must fit in the short literal form. That is, 
integers must be in the range of 0 through 63 and floating-point 
constants must be one of the 64 values listed in Table 4-2. 
Floating-point short literals are stored with a 3-bit exponent 
and a 3-bit fraction. Table 4-2 also shows the value of the 
exponent and the fraction for each literal. See the VAX-11 
Architecture Handbook for information on the format of short 


literals. 


Table 4-2 
Floating Point Short Literals 


DmNOA ObhN FO 
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ooocooooowm 


0 
1 
2 
3 
4 
5 
6 
7 


NW 





Example 
MOVL #1,RO0 RO IS SET TO 1; THE 1 IS STORED 
IN THE INSTRUCTION AS A SHORT 
LITERAL 
MOVB S*#CR,R1 THE LOW BYTE OF R1 IS SET 


TO THE VALUE CR 

CR IS STORED IN THE INSTRUCTION 
AS A SHORT LITERAL 

IF CR IS NOT IN RANGE 0-543, 

THE LINKER PRODUCES A TRUNCATION 
ERROR 

R6 IS SET TO THE FLOATING 

POINT VALUE 0.625; IT IS STORED 
IN THE FLOATING POINT SHORT 
LITERAL FORM 


MOVF #0.625,R6 


me me MO MO Te MO Te NE NS NWS We WE BW WO 


Notes 


ADDRESSING MODES 


When the #literal format is used, the assembler chooses 
whether to use literal mode or immediate mode (see Section 
4.2.4). The assembler uses immediate mode if any of the 
following conditions are met: 


e The value of the literal does not fit in the short literal 
form 


e The literal is a relocatable or external expression (see 
Section 3.5) 


e The literal is an expression that contains undefined 
symbols 


The difference between immediate mode and literal mode is the 
amount of storage that it takes to store the literal in the 
instruction. 


The S“#literal format forces the assembler to use literal 
mode. 


4.2 PROGRAM COUNTER MODES 


The program counter modes use PC for a general register. 


There are five program counter modes: 


4.2.1 


In relative mode, 


Relative 
Relative Deferred 
Absolute 
Immediate 


General 


Relative Mode 


the address specified is the address of the operand. 


The assembler stores the address as a displacement from PC. 


Relative mode can be used with index mode (see Section 4.3). 


Format 


address 


address 


An expression specifying an address; the expression can be 
preceded by one of the following displacement length specifiers, 
which indicate the number of bytes needed _ to store the 
displacement. 


Displacement 
Length Specifier 
B* 
W* 
L* 
If no displacement 
expression and_ the 


assembler chooses the smallest number 
the 
precedes the address expression and the value of 
assembler uses the default displacement length 


needed to store 


is unknown, the 


(see the description of .DEFAULT in Chapter 5). 
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Meaning 
Displacement requires 1 byte 
Displacement requires 1 word (2 bytes) 
Displacement requires 1 longword (4 bytes) 
length specifier precedes the address 
value of the expression is known,’ the 
of ,bytes (1, 2, or 4) 
displacement. If no length’ specifier 
the expression 


If the address 


ADDRESS DATA+4; 


THE ASSEMBLER 


expression is either defined later in the program or defined in 
another program section, the assembler considers the value 
unknown. 
Example 
MOVL LABEL ,R1 ; GET LONGWORD AT LABEL; THE 
; ASSEMBLER USES DEFAULT 
3; DISPLACEMENT UNLESS LABEL 
; PREVIOUSLY DEFINED IN THIS SECTION 
CMPL W*<DATA+4>,R10 ; COMPARE R10 WITH LONGWORD AT 


4.2.2 


In relative deferred mode, 
operand 


USES A WORD DISPLACEMENT 


Relative Deferred Mode 


the address specified is the address of the 
address (a pointer to the operand). The assembler stores the 


address specified as a displacement from PC. 


Relative deferred mode can be used with index mode (see Section 4.3). 


Format 


addre 


@address 


ss 
An expression specifying an address; the expression can be 
preceded by one of the following displacement length specifiers, 


which indicate the number of bytes needed _ to store the 
displacement. 
Displacement 
Length Specifier Meaning 
B* Displacement requires 1 byte 
w* Displacement requires 1 word (2 bytes) 
Ls Displacement requires 1 longword (4 bytes) 
If no displacement length specifier precedes the address 
expression and the value of the expression is known,’ the 
assembler chooses the smallest number of bytes (1, 2, or 4) 
needed to store the displacement. If no length specifier 
precedes the address expression and the value of the expression 


is unknown, the 


assembler uses the default displacement length 
(see the description of .~.DEFAULT in Chapter 5). 


If the address 


expression is either defined later in the program or defined in 
another program section, the assembler considers the value 
unknown. 
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LONGWORD AT COUNTS+4; ASSEMBLER 
USES A LONGWORD DISPLACEMENT 


Example 
CLRL @W°PNTR ; CLEAR LONGWORD POINTED TO BY 
7 LONGWORD AT PNTR; THE ASSEMBLER 
7 USES A WORD DISPLACEMENT 
INCB @L“COUNTS+4 ; INCREMENT BYTE POINTED TO BY 
; 
; 


4.2.3 Absolute Mode 

In absolute mode, the address specified is the address of the operand. 
The address is stored as an absolute virtual address (compare relative 
mode, where the address is stored as a displacement from PC). 

Absolute mode can be used with index mode (see Section 4.3). 

Format 


@#address 


address 
An expression specifying an address. 


Example 


CLRL @#*X1100 
CLRB @#ACCOUNT 


CLEAR THE CONTENTS OF LOCATION 1100 (HEX) 
CLEAR THE CONTENTS OF LOCATION 

ACCOUNT; THE ADDRESS IS STORED 
ABSOLUTELY, NOT AS A DISPLACEMENT 

CALL THE PROCEDURE SYSSFAO WITH 

THREE ARGUMENTS ON THE STACK 


CALLS #3,@#SYSSFAO 


me "OH Me MO MO TO 


4.2.4 Immediate Mode 
In immediate mode, the literal specified is the operand. 
Formats 


#literal 
I*#literal 


literal 

An expression, an integer constant, or a floating-point constant. 
Example 

MOVL #1000,R0 RO IS SET TO 1000; THE OPERAND 1000 

IS STORED IN A LONGWORD 
THE LOW BYTE OF R1 IS SET 
TO THE VALUE OF BAR 
R6 IS SET TO THE FLOATING 
POINT VALUE 0.1; IT IS STORED 
AS A 4-BYTE FLOATING POINT 
VALUE (IT CAN NOT BE 
REPRESENTED AS A SHORT LITERAL) 
THE 5 IS STORED IN A LONGWORD 
BECAUSE THE I” FORCES THE 
ASSEMBLER TO USE IMMEDIATE MODE; 


MOVB #BAR,R1 


MOVF #0.1,R6 


ADDL2 I*#5,RO0 
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Notes 


1. When the #literal format is used, the assembler chooses 
whether to use literal mode (Section 4.1.8) or immediate 
mode. If the literal is an integer from 0 through 63 or a 
floating-point constant that fits in the short literal form, 
the assembler uses literal mode. Tf the literal is an 
expression, the assembler uses literal mode if all the 
following conditions are met: 


e The expression is absolute 

e The expression contains no undefined symbols 

e The value of the expression fits in the short literal form 
In all other cases, the assembler uses immediate mode. 


The difference between immediate mode and literal mode is the 
amount of storage required to store the literal in the 
instruction. The assembler stores an immediate mode literal 
in a byte, word, or longword depending on the operand data 
type. 


2. The I*#literal format forces the assembler to use immediate 
mode, 


4.2.5 General Mode 


In general mode, the address specified is the address of the operand. 
The linker converts the addressing mode to either relative or absolute 
mode. If the address is relocatable, the linker converts general mode 
to relative mode. If the address is absolute, the linker converts 
general mode to absolute mode. General mode is used to _ write 
position-independent code when the programmer does not know whether 
the address is relocatable or absolute. A general addressing mode 
operand requires 5 bytes of storage. 


General mode can be used with index mode (see Section 4.3). 
Format 
G“address 


address 
An expression specifying an address. 


Example 


CLEARS THE LONGWORD AT LABEL 1 
IF LABEL 1 IS DEFINED AS ABSOLUTE 
THEN THIS IS CONVERTED TO ABSOLUTE 
MODE; IF IT IS DEFINED AS 
RELOCATABLE, THEN THIS IS CONVERTED 
TO RELATIVE MODE 
CALLS #5,G°SYSSSERVICE ; CALLS PROCEDURE SYSSSERVICE 

; WITH 5 ARGUMENTS ON STACK 


CLRL G*LABEL_1 
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4.3 INDEX MODE 

Index mode is a general register mode that can be used only in 
combination with another mode, called the base mode. The base mode 
can be any addressing mode except register, immediate, literal, index, 
or branch. The assembler first evaluates the base mode to get the 
base address. Then the assembler adds the base address to the product 
of the contents of the index register and the number of bytes of the 
operand data type. This sum is the operand address. 


Combining index mode with the other addressing modes produces’ the 
following addressing modes: 


e Register Deferred Index 

e Autoincrement Index 

e Autoincrement Deferred Index 
e Autodecrement Index 

e Displacement Index 

e Displacement Deferred Index 
e Relative Index 

e Relative Deferred Index 

e Absolute Index 

e General Index 


The process of first evaluating the base mode and then adding the 
index register is the same for each of these modes. 


Formats 


base-mode [Rx] 
base-mode [AP] 
base-mode [FP] 
base-mode [SP] 


base-mode 


Any addressing mode except register, immediate, literal, index, 
or branch, specifying the base address. 


A number in the range 0 through 12, specifying the index 
register. 


Table 4-3 lists the formats of index mode addressing. 


ADDRESSING MODES 


Examples 
3; REGISTER DEFERRED INDEX MODE 
i 
OFFS=20 
MOVAB BLIST,R9 
MOVL #OFFS,R1 
CLRB (R9) [R1] 
CLRQ (R9) [R1] 
CLRO (R9) [R1] 


AUTOINCREMENT INDEX MODE 


me Me TO 


CLRW (R9)+{R1] 


me me MO 


MOVAL POINT,R8 
MOVL #30,R2 
CLRW @(R8)+[R2] 


=e se we 


MOVAL  ADDARR,R9 
MOVL #100,R1 
TSTF @40(R9) [R1] 


me te MO Me Me MO NO MO MO MO TO NO 


me "=6 Se BO 


™e te Me NO TO We ME 


DISPLACEMENT DEFERRED INDEX MODE 


me ™e we Te we 


DEFINE OFFS 

GET ADDRESS OF BLIST 
SET UP INDEX REGISTER 
CLEAR BYTE WHOSE ADDRESS 
IS THE ADDRESS OF BLIST 
PLUS 20*1 

CLEAR QUADWORD WHOSE 
ADDRESS IS THE ADDRESS 
OF BLIST PLUS 20*8 
CLEAR OCTAWORD WHOSE 
ADDRESS IS THE ADDRESS 
OF BLIST PLUS 20*16 


CLEAR WORD WHOSE ADDRESS 
IS ADDRESS OF BLIST PLUS 
20*2; R9 NOW CONTAINS 
ADDRESS OF BLIST+2 


AUTOINCREMENT DEFERRED INDEX MODE 


GET ADDRESS OF POINT 

SET UP INDEX REGISTER 
CLEAR WORD WHOSE ADDRESS 
IS 30*2 PLUS THE ADDRESS 
STORED IN POINT; R8 NOW 
CONTAINS 4 PLUS ADDRESS OF 
POINT 


GET ADDRESS OF ADDRESS ARRAY 

SET UP INDEX REGISTER 

TEST FLOATING POINT VALUE 

WHOSE ADDRESS IS 100*4 PLUS 

THE ADDRESS STORED AT (ADDARR+40) 


* Ke 


Notes 


ADDRESSING MODES 


Table 4-3 
Index Mode Addressing 


Register Deferred Index (Rn) [Rx] 


Autoincrement Index (Rn) +[Rx] 


Autoincrement Deferred @(Rn)+[{Rx] 
Index 


Autodecrement Index ~(Rn) [Rx] 
Displacement Index dis(Rn) [Rx] 


Displacement Deferred @dis(Rn) [Rx] 
Index 


Relative Index address [Rx] 
Relative Deferred Index @address [Rx] 
Absolute Index @#address [Rx] 


General Index G*address [Rx] 





y: 

Rn 
Any general register RO through R12 or the AP, FP, or _ SP 

register. 

Rx 
Any general register RO through R12 or the AP, FP, or _ SP 

register. Rx cannot be the same register as Rn in the 
autoincrement index, autoincrement deferred index, and 
decrement index addressing modes. 

dis 
An expression specifying a displacement. 

address 
An expresSion specifying an address. 

l. If the base mode alters the contents of its’ register 
(autoincrement, autoincrement deferred, and autodecrement), 
the index mode cannot specify the same register. 

2. The index register is added to the address after the base 


mode is completely evaluated. For example, in autoincrement 
deferred index mode, the base register contains the address 
of the operand address. The index register (times the length 
of the operand data type) is added to the operand address 
rather than to the address stored in the base register. 


ADDRESSING MODES 


4.4 BRANCH MODE 


In branch mode, the address is stored as an implied displacement from 
PC. This mode can only be used in branch instructions. The 
displacement for conditional branch instructions and the BRB 
instruction is stored in a byte. The displacement for the BRW 
instruction is stored in a word (2 bytes). A byte displacement allows 
a range of 127 bytes forward and 128 bytes backward. A word 
displacement allows a range of 32767 bytes forward and 32768 bytes 
backward. The displacement is relative to the updated PC, the byte 
past the byte or word where the displacement is stored. See the 
VAX-11 Architecture Handbook for more information on_ the branch 
instructions. 


Format 
address 


address 
An expression that represents an address. 


Example 


ADDL3 (R1)+,RO,TOTAL TOTAL VALUES AND SET CONDITION 


CODES 


=e te ™O Me TO 


BLEQ LABEL1 BRANCH TO LABEL] IF RESULT IS 
LESS THAN OR EQUAL TO O 
BRW LABEL BRANCH UNCONDITIONALLY TO LABEL 


CHAPTER 5 


GENERAL ASSEMBLER DIRECTIVES 


The general assembler directives provide facilities for performing 
eleven types of functions. Table 5-1 lists these types of functions 
and the directives that fall under’ them, The remainder of this 
chapter describes the directives in detail, showing their formats and 
giving examples of their use. For ease of reference, the directives 
are presented in alphabetical order in this chapter. In addition, 
Appendix B contains a summary of all assembler directives. 


Table 5-1 
Summary of General Assembler Directives 




















Listing Control .- SHOW (.LIST) 
Directives -NOSHOW (.NLIST) 
~TITLE 
~SUBTITLE (.SBTTL) 
~ IDENT 


- PAGE 








-PRINT 
-WARN 
- ERROR 


Message Display 
Directives 




























Assembler Option 
Directives 


~-ENABLE (.ENABL) 
-DISABLE (.DSABL) 
-DEFAULT 












Data Storage 
Directives 


-BYTE 
«WORD 

. LONG 

. ADDRESS 

«QUAD 

.OCTA 

- PACKED 

-ASCII 

-ASCIC 

-ASCID 

-ASCIZ 

»F_FLOATING (.FLOAT) 
-D_FLOATING (.DOUBLE) 
.G FLOATING 

.H FLOATING 

-SIGNED_ BYTE 

. SIGNED WORD 









1. The alternate form, if any, is given in parentheses. 
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Table 5-1 (Cont.) 
Summary of General Assembler Directives 


Location Control 
Directives 


Program 
Sectioning ~SAVE_PSECT (.SAVE) 
Directives «RESTORE_PSECT (.RESTORE) 


Symbol Control ~-GLOBAL (.GLOBL) 
Directives »~EXTERNAL (.EXTRN) 
Directives » DEBUG 

«WEAK 


Routine Entry Point ~ ENTRY 
Definition - TRANSFER 
Directives _ - MASK 


Conditional ~IF 

and Subconditional » ENDC 

Assembly -IF_ FALSE (.IFF) 

Block Directives -IF TRUE (IFT) 
.IF TRUE FALSE (.IFTF) 
LIF - 


Cross-Reference ~CROSS 
Directives ~NOCROSS 


Instruction -OPDEF 

Generation ~REF1 

Directives ~-REF2 
e~REF4 
~REF8 
~REF16 





1. The alternate form, if any, is given in parentheses. 
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-ADDRESS 


-ADDRESS -- ADDRESS STORAGE DIRECTIVE 
-ADDRESS stores successive longwords containing addresses in the 
object module. DIGITAL recommends that .ADDRESS rather than .LONG be 
used for storing address data to provide additional information to the 
linker. In shareable images, addresses specified with .ADDRESS 
produce position-independent code. See the VAX-11 MACRO User's Guide 
for a discussion of specifying addresses in position-independent code. 
Format 
e-ADDRESS address-list 
Parameter 
address-list 
A list of symbols or expressions, separated by commas, that 
VAX-11 MACRO interprets as addresses. Repetition factors are not 
allowed. 
Example 


TABLE: .ADDRESS LAB_4,LAB_ 3,ROUTTERM ; REFERENCE TABLE 
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-ALIGN 
-ALIGN -- LOCATION COUNTER ALIGNMENT DIRECTIVE 


-ALIGN aligns the location counter to the boundary specified by either 
an integer or a keyword. 


Formats 


-ALIGN integer[,expression] 
-ALIGN keyword[,expression] 


Parameters 
integer 


An integer in the range of 0 through 9. The location counter is 
aligned at an address that is the value of 2 raised to the power 
of the integer. 


keyword 


One of five keywords that specify the alignment boundary. The 
location counter is aligned to an address’ that is the next 
multiple of the values listed below. 


Keyword Size (in Bytes) 


BYTE 2*0 
WORD 2* 1 
LONG 2*2 
QUAD 2°3 
PAGE 2°9 


Mo PMH 


expression 


Specifies the fill value to be stored in each byte. The 
expression must not contain any undefined symbols and must be an 
absolute expression (see Section 3.5). 


Example 


ALIGN BYTE,0 
e-ALIGN WORD 
-ALIGN 3,°A/ / 
eALIGN PAGE 


BYTE ALIGNMENT-FILL WITH NULL 
WORD ALIGNMENT 

QUAD ALIGNMENT-FILL WITH BLANKS 
PAGE ALIGNMENT 


=e Ne te US 


Notes 


1. The alignment specified in .ALIGN cannot exceed the alignment 
of the program section in which the alignment is attempted 
(see the description of .PSECT). For example, if the default 
program section alignment (BYTE) is being used and .ALIGN is 
specified with a WORD or larger alignment, the assembler 
displays an error message. 


2. If the optional expression is supplied, the bytes skipped by 
the location counter (if any) are filled with the value of 
that expression. Otherwise, the bytes are zero filled. 
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3. Although most instructions do not require any data alignment 
other than byte alignment, execution speed is improved by the 
following alignments: 


Data Length Alignment 
Word Word 
Longword Longword 
Quadword Quadword 
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.ASCIx 


-ASCIx -- ASCII CHARACTER STORAGE DIRECTIVES 


VAX~11 MACRO has four ASCII character storage directives: 


Directive Function 

ASCII ASCII string storage 

ASCIC Counted ASCII string storage 

ASCID String-descriptor ASCII string storage 
ASCIZ Zero-terminated ASCII string storage 


Each directive is followed by a string of characters enclosed in a 
pair of matching delimiters. The delimiters can be any printable 
character except the space, tab, equal sign (=), semicolon (;), or 
left angle bracket (<). The character used as the delimiter cannot 
appear in the string itself. Alphanumeric characters can be used as 
delimiters; however, nonalphanumeric characters should be used to 
avoid confusion. . 


Any character except the null, carriage return, and form feed 
characters can appear within the string. The assembler does not 
convert lowercase alphabetic characters to uppercase. 


ASCII character storage directives convert the characters to their 
8-bit ASCII value (see Appendix A) and store them one character to a 
byte. 


Any character, including the null, carriage return, and form feed 
characters, can also be represented by an expression enclosed in angle 
brackets outside of the delimiters. You must define the ASCII values 
of null, carriage return, and form feed with a direct assignment 
statement. The ASCII character storage directives store the 8-bit 
binary value specified by the expression. 


ASCII strings can be continued over several lines but the string on 
each line must be delimited at both ends; however, a different pair 
of delimiters can be used for each line. For example: 


CR=13 
LF=10 


eASCII /ABC DEFG/ 
-ASCIZ @Any character can be delimiter@ 


-ASCIC ? lowercase is not converted to UPPER? 
-ASCII ? this is a test!?<CR><LF>!Isn't it?! 
-ASCII \ Angle Brackets <are part <of> this> string \ 
-ASCII / This string is continued / - 
\ on the next line \ 
-ASCII <CR><LF>! this string includes an expression! - 


<128+CR>? whose value is a 13 plus 128? 


The following sections describe each of the four ASCII character 
storage directives, giving the formats and examples of each. 
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-ASCII 


eASCII -- ASCII STRING STORAGE DIRECTIVE. 


-ASCII stores in the next available byte the ASCII value of each 
character in the ASCII string or the value of each byte expression. 


Format 

eASCII string 
Parameter 
string 


A delimited ASCII string. 


Example 
CR=13 DIRECT ASSIGNMENT STATEMENTS 
LF=10 DEFINE CR AND LF 


eASCII “DATE: 17-NOV-1979" 
eASCII /EOF/<CR><LF> 


DELIMITER IS " 
DELIMITER IS / 


=e es Me NO 


-ASCIC 


eASCIC -- COUNTED ASCII STRING STORAGE DIRECTIVE 

-ASCIC performs the same function as _ .ASCII, except that .ASCIC 
inserts a count byte before the string data. The count byte contains 
the length of the string in bytes. The length given includes’ any 
bytes of nonprintable characters outside the delimited string but 
excludes the count byte. 


-ASCIC is useful in copying text because the count indicates’ the 
length of the text to be copied. 


Format 
eASCIC string 
Parameter 
string 
A delimited ASCII string. 
Example 


CR=13 DIRECT ASSIGNMENT STATEMENT DEFINES CR 


=e 


eASCIC #HELLO#<CR> THIS COUNTED ASCII STRING 
IS EQUIVALENT TO 
THE COUNT 


FOLLOWED BY THE ASCII STRING 


» BYTE 6 
eASCII #HELLO#<CR> 


=e Se MO Ne 
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-ASCID 


eASCID -- STRING-DESCRIPTOR ASCII STRING STORAGE DIRECTIVE 


-ASCID performs the same function as ASCII, except that .ASCID inserts 
a string descriptor before the string data. The string descriptor 
consists of 1) two bytes that specify the length of the string, 2) two 
bytes of descriptor information, and 3) a _ longword containing a 
position-independent pointer to the string. String descriptors are 
used in calling procedures (see Appendix C of the VAX-11 Architecture 
Handbook). Position-independence is discussed in the VAX-11 MACRO 
User's Guide. 


Format 
-ASCID string 
Parameter 
string 
A delimited ASCII string. 
Example 


STRING DESCRIPTOR 
ANOTHER ONE 


DESCR1: .ASCID /ARGUMENT FOR CALL/ 
DESCR2: .ASCID /SECOND ARGUMENT/ 


=e ™e 


PUT ADDRESS OF DESCRIPTORS 
ON THE STACK 
CALL PROCEDURE 


PUSHAL DESCR1 
PUSHAL DESCR2 
CALLS #2,STRNG_PROC 


me Se Ne 


-ASCIZ 


eASCIZ -- ZERO-TERMINATED ASCII STRING STORAGE DIRECTIVE 
-ASCIZ performs the same function as _ .ASCII, except that .ASCIZ 
appends a null byte as the final character of the string. Thus, when 
a list or text string is created with an .ASCIZ directive, the user 
need only perform a search for the null character in the last byte to 
determine the end of the string. 
Format 

-ASCIZ string 
Parameter 
String 

A delimited ASCII string. 
Example 
FF=12 ; DEFINE FF 
6 CHARACTERS IN STRING 
7 BYTES OF DATA 


3 CHARACTERS IN STRINGS 
4 BYTES OF DATA 


eASCIZ /ABCDEF/ 


eASCIZ /A/<FF>/B/ 


=e te "Oe MO 
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.BLKx 


~-BLKx -- BLOCK STORAGE ALLOCATION DIRECTIVES 


VAX-11 MACRO has ten block storage directives: 


Directive Function 

~BLKA Reserves storage for addresses (longwords) 
-BLKB Reserves storage for byte data 

-BLKD Reserves storage for double-precision, 


floating-point data (quadwords) 


- BLKF Reserves storage for single-precision, 
floating-point data (longwords) 


- BLKG Reserves storage for G floating data (quadwords) 
-BLKH Reserves storage for H_ floating data (octawords) 
»BLKL Reserves storage for longword data 

~BLKO Reserves storage for octaword data 

-BLKQ Reserves storage for quadword data 

-BLKW Reserves storage for word data 


Each directive reserves storage for a different data type. The value 
of the expression determines the number of data items for which VAX-11l 
MACRO reserves storage. For example, .BLKL 4 reserves storage for 4 
longwords of data and .BLKB 2 reserves storage for 2 bytes of data. 


The total number of bytes reserved is equal to the length of the data 
type times the value of the expression as follows: 


Directive Number of Bytes Allocated 
-BLKB Value of expression 
-BLKW 2 * value of expression 
~-BLKA 

-BLKF 4 * value of expression 
eBLKL 

-BLKD 8 * value of expression 
-BLKG 

-BLKQ 

- BLKH 16 * value of expression 
-BLKO 


Formats 


-BLKA 
-BLKB 
-BLKD 
- BLKF 
- BLKG 
- BLKH 
-BLKL 
-BLKO 
-BLKQ 
-BLKW 


Parameter 


expression 


An expresSion specifying the amount of storage to 
the 
expression must be an absolute expression (see Section 3.5). 


All 


expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 


symbol 
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s in the expr 


be allocated. 
defined and the 
Tf 


ession must be 


the expression is omitted, a default value of 1 is assumed. 


Example 
-BLKB 15 
-BLKO 3 
eBLKL 1 
-BLKF <3*4> 


me *Oe we MO NO 


SPACE FOR 15 BYTES 

SPACE FOR 3 OCTAWORDS (48 BYTES) 
SPACE FOR 1 LONGWORD (4 BYTES) 
SPACE FOR 12 SINGLE PRECISION 
FLOATING-POINT VALUES (48 BYTES) 
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.BYTE 


-BYTE -- BYTE STORAGE DIRECTIVE 

-BYTE generates successive bytes of binary data in the object module. 

Format 
-BYTE expression-list 

Parameter 

expression-list 
One or more expressions separated by commas. Each expression is 
first evaluated as a longword expression. Then the value of each 
expression is truncated to 1 byte. The value of each expression 
should be in the range of 0 through 255 for unsigned data or in 
the range of -128 through +127 for signed data. 
Each expression optionally can be followed by a repetition factor 
delimited by square’. brackets. An expression followed by a 
repetition factor has the format: 

expressionl fexpression2] 

expressionl 
An expression that specifies the value to be stored. 

{expression2] 
An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 


symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 


Example 
BYTE <1024-1000>*2 ; STORES A VALUE OF 48 
~BYTE “XA,FIF,10,65-<21*3> ; STORES 4 BYTES OF DATA 
~BYTE 0 ; STORES 1 BYTE OF DATA 
~BYTE X,X+3(5*4] ,Z ; STORES 22 BYTES OF DATA 
Notes 


1. The assembler displays an error message if the high-order 3 
bytes of the longword expression has a value other than 0 or 
“XFFFFFF. 


2. At link time, a relocatable expression can result ina value 
that exceeds 1 byte. In this case, the VAX-1ll Linker issues 
a truncation diagnostic message for the object module in 
question. For example: 
A: -BYTE A RELOCATABLE VALUE 'A‘' WILL 
CAUSE VAX-11 LINKER TRUNCATION 
DIAGNOSTIC IF THE STATEMENT 
HAS A VIRTUAL ADDRESS OF 256 
OR ABOVE 


me me Me MO BO 


3. The .SIGNED BYTE directive is the same as .BYTE except’ the 
assembler displays a diagnostic message if a value in the 
range from 128 to 255 is specified. See the description of 
~SIGNED BYTE for more information. 


5-11 
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-CROSS 
.NOCROSS 


-CROSS AND .NOCROSS -- CROSS-REFERENCE DIRECTIVES 


VAX-11 MACRO produces a cross-reference listing when the CROSS 
qualifier is specified in the MACRO command. The .CROSS and .NOCROSS 
directives control which symbols are included in the cross-reference 
listing. The .CROSS and .NOCROSS directives have an effect only if 
/CROSS REFERENCE was specified in the MACRO command (see the VAX-11 
MACRO User's Guide). 


By default, the cross-reference listing includes the definition and 
all the references to every symbol in the module. The cross-reference 
listing can be disabled for all symbols or for a specified list of 
symbols. 


eNOCROSS without a symbol list disables the cross-reference listing of 
all symbols. -CROSS without a symbol list reenables’' the 
cross-reference listing. Any symbol definition or reference that 
appears after .NOCROSS without a symbol list and before the next 
-CROSS with no argument list is excluded from the cross” reference 
listing. 


-NOCROSS with a symbol list disables the cross-reference listing for 
the listed symbols. -CROSS with a symbol list reenables’~ the 
cross-reference listing of the listed symbols. 
Formats 

-CROSS 

-CROSS symbol-list 

-NOCROSS 

-NOCROSS symbol-list 
Parameter 
symbol-list 


A list of legal symbol names separated by commas. 


Examples 

~NOCROSS ; STOP CROSS REFERENCE 
LAB1: MOVL LOC1,LOC2 7 COPY DATA 

-CROSS ; REENABLE CROSS REFERENCE 


The definition of LABl and the references to LOCl and LOC2 are _ not 
included in the cross reference listing. 


-NOCROSS LOC1 DO NOT CROSS REFERENCE LOCI] 


LAB2: MOVL LOC1,LOC2 ; COPY DATA 
-CROSS LOC] ; REENABLE CROSS REFERENCE 
7; OF LOCI 


The definition of LAB2 and the reference to LOC2 are included in the 
cross reference, but the reference to LOC] is not included in the 
cross reference. 


Notes 
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-CROSS without a symbol list will not reenable the 
cross-reference listing of a symbol specified in .NOCROSS 
with a symbol list. 


If the cross-reference listing of all symbols is disabled, 
-CROSS with a symbol list will have no effect until the 
cross-reference listing is reenabled by .CROSS without a 
symbol list. 
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-DEBUG 


-DEBUG -- DEBUG SYMBOL ATTRIBUTE DIRECTIVE 
-DEBUG specifies that the symbols in the list are made known to the 
debugger. During an interactive debugging session, these symbols can 


be used to refer to memory locations or to examine the values assigned 
to the symbols. 


Format 
~-DEBUG symbol-list 
Parameter 
symbol-list 
A list of legal symbols separated by commas. 
Example 
-DEBUG INPUT,OUTPUT,- ; MAKE THESE SYMBOLS KNOWN 
LAB 30,LAB_ 40 ; TO THE DEBUGGER 
Note 
The assembler adds the symbols in the symbol list to the symbol 
table in the object module. The programmer need not specify 
global symbols in the .DEBUG directive because global symbols 
automatically are put in the object moduule's symbol table. See 


the description of .ENABLE for information on making information 
about all symbols available to the debugger. 
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-DEFAULT 


~-DEFAULT -- DEFAULT CONTROL DIRECTIVE 


-DEFAULT determines the default displacement length for the relative 
and relative deferred addressing modes (see Sections 4.2.1 and 4.2.2). 


Format 

-DEFAULT DISPLACEMENT, keyword 
Parameter 
keyword 


One of three keywords--BYTE, WORD, LONG--indicating the default 
displacement length. 


Example 
-DEFAULT DISPLACEMENT ,WORD ; WORD IS DEFAULT 
MOVL LABEL,R1 ; ASSEMBLER USES WORD 
; DISPLACEMENT UNLESS 
; LABEL HAS BEEN DEFINED 
- DEFAULT DISPLACEMENT, LONG ; LONG IS DEFAULT 
INCB @COUNTS+4 ; ASSEMBLER USES LONGWORD 
; DISPLACEMENT UNLESS 
; COUNTS HAS BEEN DEFINED 
Notes 


1. .DEFAULT has no effect on the default displacement for 
displacement and displacement deferred addressing modes (see 
Sections 4.1.6 and 4.1.7). 


2. If there is no .DEFAULT in a source module, the default 
displacement length for the relative and relative deferred 
addressing modes is a longword. 
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.D_FLOATING 
.DOUBLE 


-D_FLOATING ~- FLOATING POINT STORAGE DIRECTIVE 


-D_ FLOATING evaluates the specified floating-point constants and 
stores the results in the object module. -D_FLOATING generates 
64-bit, double-precision, floating-point data (1 bit of sign, 8 bits 
of exponent, and 55 bits of fraction). See the description of 
~F_FLOATING for information on storing single precision floating point 
numbers and the descriptions of .G FLOATING and _ .H FLOATING for 
descriptions of other floating point numbers. ~~ 


Format 


-D_FLOATING literal-list 
-DOUBLE literal-list 


Parameter 
literal-list 


A list of floating-point constants (see Section 3.2.2). The 
constants cannot contain any unary or binary operators except 
unary plus or unary minus. 


Example 


CONSTANT 


-D_ FLOATING 1000,1.0E3,1.0000000E-9 
LIST 


- DOUBLE 3.1415928, 1.1071534238 28 
-D_ FLOATING 5, 10, 15, 0, 0.5 


=e WO MO 


1. Double precision floating point numbers are always’ rounded. 
They are not affected by .~.ENABLE TRUNCATION. 


2. The floating point constants in the literal list must not be 
preceded by the floating point operator (“F). 
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-DISABLE 


~DISABLE -- FUNCTION CONTROL DIRECTIVE 


~-DISABLE disables, or inhibits, the specified assembler functions. 
See the description of .ENABLE for more information. 


Format 
-DISABLE argument-list 

Parameter 

argument-list 
One or more of the symbolic arguments listed in Table 5-2 in the 
description of .ENABLE. Either the long form or the short form 
of the symbolic arguments can be used. If multiple arguments are 


specified, they must be separated by commas,. spaces, or tabs. 


Note 


The alternate form of .DISABLE is .DSABL. 


-ENABLE 


~ ENABLE -- FUNCTION CONTROL DIRECTIVE 


-ENABLE enables the specified assembly function. -ENABLE and its 
negative form, .DISABLE, control the following assembler functions. 


e Creating local label blocks. 


e Making all local symbols available to the debugger’ and 
enabling the traceback feature. 


e Specifying that undefined symbol references are external 
references. 


e Truncating or rounding single-precision floating-point 
numbers. 


e Suppressing the listing of symbols that are defined but not 
referenced. 


e Specifying that all PC references are absolute not relative. 
Format 
~ENABLE argument-list 
Parameter 
sveuimeneztese 
One senor of the symbolic arguments listed in Table 5-2. 
Either the long form or the short form of the symbolic arguments 


can be used. 


If multiple arguments are specified, they must be separated by 
commas, spaces, or tabs. 


ae | 


Long Form 


ABSOLUTE 


GLOBAL 


LOCAL_BLOCK 


SUPPRESSION 


TRACEBACK 


GENERAL ASSEMBLER DIRECTIVES 


Table 5-2 


-ENABLE and .DISABLE Symbolic Arguments 


Default 
Short Form Condition 


Disabled 


Disabled 


Enabled 


Disabled 


Disabled 


Enabled 


Function 


pccetson tt: aitmenirnss omit sheeted rarest ent Samat i Af sn as 


When ABSOLUTE is enabled, 
all PC relative addressing 
modes are assembled as 
absolute addressing modes. 


When DEBUG is enabled, all 
local symbols are included 
in the object module's 
symbol table for use by 
the debugger. 


When GLOBAL is enabled, 
all undefined symbols are 
considered external 
symbols. When GLOBAL is 
disabled, any undefined 
symbol that is not listed 
in a .EXTERNAL directive 
causes an assembly error. 


When LOCAL BLOCK is 
enabled, the current local 
label block is ended and a 
new one is Started. When 
LOCAL BLOCK is disabled, 


the current local label 
block is ended. See 
Section 3.4 for a complete 
description of local label 
blocks. 


When SUPPRESSION is 
enabled, all symbols that 
are defined but not 
referred to are not listed 
in the symbol table. When 
SUPPRESSION is disabled, 
all symbols that are 
defined are listed in the 
symbol table. 


When TRACEBACK is enabled, 
the program section names 
and lengths, module names, 
and routine names are 
included in the object 
module for use by the 
debugger. When TRACEBACK 
is disabled, VAX-11 MACRO 
excludes this information 
and, in addition, does not 
make any local symbol 
information available to 
the debugger. 





(continued on next page) 
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Table 5-2 (Cont.) 
-ENABLE and .DISABLE Symbolic Arguments 


Default 
Long Form Short Form Condition Function 





TRUNCATION FPT Disabled When TRUNCATION is 
enabled, single-precision 
floating-point numbers are 
truncated. When 
TRUNCATION is disabled, 
single-precision 
floating-point numbers are 
rounded. D floating, 

G floating, and H floating 
numbers are not affected 
by .ENABLE TRUNCATION; 
they are always rounded. 


Example » 


~ENABLE ABSOLUTE, GLOBAL ; ASSEMBLE RELATIVE ADDRESS MODE 
; AS ABSOLUTE ADDRESS MODE. 

; UNDEFINED REFERENCES ARE GLOBAL 
-DISABLE TRUNCATION , TRACEBACK ; ROUND FLOATING-POINT NUMBERS. 
; DO NOT PUT ANY DEBUGGING 
; 


INFORMATION INTO OBJECT MODULE 
Note 


The alternate form of .ENABLE is .ENABL. 
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-END 


-END -- ASSEMBLY TERMINATION DIRECTIVE 


~-END terminates the source program. No additional text should occur 
beyond this point in the current source file or in any additional 
source files specified in the command line for this assembly. If any 
additional text does occur, the assembler ignores the text. The 
additional text does not appear in either the listing file or the 
object file. 


Format 

-END [symbol] 
Parameter 
symbol 


The address (called the transfer address) at which program 
execution is to begin. 


Example 


MAIN PROGRAM 


e-ENTRY START,O + ENTRY MASK 
; 


- END START 


1. The transfer address must be in a program section that has 
the EXE attribute (see the description of .PSECT). 


2. When an executable image consisting of several object modules 
is linked, only one object module should be terminated by an 
-END directive that specifies a transfer address. All other 
object modules should be terminated by .END directives that 
do not specify a transfer address. If an executable image 
either contains no transfer address or contains more than one 
transfer address, the VAX-11 Linker displays an error 
message. 


3. If the source program contains an unterminated conditional 


code block when the .END directive is specified, the 
assembler displays an error message. 


-ENDC 


eENDC -- END CONDITIONAL DIRECTIVE 


-ENDC terminates the conditional range started by the .IF directive. 
See the description of .IF for more information and examples. 


Format 


- ENDC 
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-ENTRY 


eENTRY -- ENTRY DIRECTIVE 


~-ENTRY defines a symbolic name for an entry point and stores a 
register save mask (2 bytes) at that location. The symbol is defined 
as a global symbol with a value equal to the value of the location 
counter at the .ENTRY directive. The entry point can be used as the 
transfer address of the program. The register save mask is used _ to 
determine which registers are saved before the procedure is called. 
These saved registers are automatically restored when the _ procedure 
returns control to the calling program. See the description of the 
procedure call instructions in the VAX-11 Architecture Handbook. 


Format 
~ENTRY symbol,expression 
Parameter 
symbol 
The symbolic name for the entry point. 
expression 
The register save mask for the entry point. The expression must 
be an absolute expression and must not contain any undefined 
symbols. 
' Example 
PROCEDURE STARTS HERE. 
REGISTERS 2,3,7 ARE 


PRESERVED BY CALL AND 
RET INSTRUCTIONS 


»ENTRY CALC,“*M<R2,R3,R7> 


me ™e MO Me 


Notes 


1. The. register mask operator (“M) is convenient to use. for 
setting the bits in the register save mask (see Section 
3464262) 


2. An assembly error occurs if the expression has bits 0, 1, 12, 
or 413 = set. These bits correspond to the registers. RO, Rl, 
AP, and FP and are reserved for the CALL interface. 


3. DIGITAL recommends that .ENTRY be used to define all callable 
entry points including the transfer address of the program. 
Although the following construct also defines an entry point, 
its use is discouraged: 


symbol:: .WORD expression 
Although a procedure starting with this construct can _ be 


called, the entry mask is not checked for any illegal 
registers and the symbol cannot be used in a .MASK directive. 
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~ENTRY should be used only for procedures that will be called 
by the CALLS or CALLG instruction. A routine that is entered 
by the BSB or JSB instruction should not use .ENTRY because 
these instructions do not expect a register save mask. These 
routines should begin in the following format: 


symbol:: first instruction 


The first instruction of the routine immediately follows’ the 
symbol. 
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-ERROR 


»~ERROR -- ERROR DIRECTIVE 


-ERROR causes the assembler to display an error message on the 
terminal or batch log file and in the listing file (if there is one). 


Format 

»~ERROR [expression] ; comment 
Parameters 
expression 


An expression whose value is displayed when .ERROR is encountered 
during assembly. 


7; comment 


A comment that is displayed when .ERROR is encountered during 
assembly. The comment must be preceded by a semicolon. 


Example 
.IF DEFINED LONG_MESS 
.IF GREATER 1000-WORK_AREA 
«ERROR 25 ; NEED LARGER WORK AREA 
. ENDC . 
. ENDC 


If the symbol LONG MESS is defined and if the symbol WORK_AREA has a 
value of 1000 or less, the following error message is displayed: 


%MACRO—-E-GENERR, Generated ERROR: 25 NEED LARGER WORK_AREA 
Notes 


1. .ERROR, .WARN, and .PRINT are called the message display 
directives. They can be used to display information 
indicating that a macro call contains an error or an illegal 
set of conditions (see Chapter 6 for more information on 
macro calls). 


2. When the assembly is finished, the assembler displays’ the 
total number of errors, warnings, and information messages, 
and the sequence numbers of the lines causing the errors or 
warnings on the terminal. See the VAX-11 MACRO User's Guide 
for more information on errors and warnings. 


3. If .ERROR is included in a macro library (see the VAX-11 
MACRO User's Guide), the comment should end with an 
additional semicolon. Otherwise, the librarian will strip 
the comment from the directive and it will not be displayed 
when the macro is called. 


4. The line containing the .ERROR directive is not included in 
the listing file. 


5. If the expression has a value of 0, it is not displayed in 
the error message. 
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-EVEN 


~EVEN -- EVEN LOCATION COUNTER ALIGNMENT DIRECTIVE 

-EVEN ensures that the current value of the location counter is even 
by adding 1 if the current value is odd. If the current value is 
already even, no action is taken. 


Format 


- EVEN 


-EXTERNAL 


e-EXTERNAL -- EXTERNAL SYMBOL ATTRIBUTE DIRECTIVE 
-EXTERNAL indicates that specified symbols are external; that is, the 
symbols are defined in another object module and cannot be defined 
until link time (see Section 3.3.3). 
Format 
.EXTERNAL symbol-list 
Parameter 
symbol-list 
A list of legal symbols separated by commas. 
Example 


THESE SYMBOLS ARE DEFINED IN 
EXTERNALLY ASSEMBLED MODULES 


. EXTERNAL SIN, TAN,COS 
. EXTERNAL SINH,COSH, TANH 


se Ne 


Notes 


1. If the GLOBAL argument is enabled (see Table 5-2 in the 
description of .ENABLE), all unresolved references will be 
marked as global and external. Thus, if GLOBAL is’ enabled, 
the programmer need not specify .EXTERNAL. However, if 
GLOBAL is disabled, the programmer must explicitly specify 
-EXTERNAL to declare any symbols that are defined externally 
but referred to in the current module. 


2. If GLOBAL is disabled and the assembler finds symbols” that 
are not defined in the current module and are not listed ina 
-EXTERNAL directive, the assembler displays an error message. 


3. The alternate form of .EXTERNAL is .EXTRN. 
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-F_FLOATING 
-FLOAT 


-F_ FLOATING (.FLOAT) -- FLOATING-POINT STORAGE DIRECTIVE 


-F_FLOATING evaluates the specified floating-point constants and 
stores the results in the object module. -F_ FLOATING generates 
32-bit, single-precision, floating-point data (1 bit of sign, 8 bits 
of exponent, and 23 bits of fractional significance). See the 
description of .D FLOATING for information on storing double-precision 
floating-point numbers and the descriptions of .G FLOATING and 
-H_FLOATING for descriptions of other floating point numbers. 


Format 


.F_FLOATING literal-list 
-FLOAT literal-list 


Parameter 
literal-list 


A list of floating-point constants (see Section 3.2.2). The 
constants cannot contain any unary or binary operators except 
unary plus and unary minus. 


Example 


SINGLE PRECISION 

THESE ALL GENERATE 134.2 
DATA 

LIST 


-F_FLOATING 134.5782,74218.34E20 
-F_FLOATING 134.2,0.134283,1342E-1 
-F FLOATING -0.75,1E38,-1.0E-37 

- FLOAT 0,25,50 


me we tO we 


Notes 


1. See the description of .ENABLE for information on specifying 
floating-point rounding or truncation. 


2. The floating point constants in the literal list must not be 
preceded by the floating point unary operator (“F). 
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-G_FLOATING 


-G_FLOATING -- G FLOATING POINT STORAGE DIRECTIVE 
G FLOATING evaluates the specified floating-point constants and stores 
the results in the object module. .G FLOATING generates 64-bit data 
(1 bit of sign, 11 bits of exponent, and 52 bits of fraction). 
Format 
-G_ FLOATING literal-list 
Parameters 
literal-list 
A list of G floating point constants (see Section 3.2.2). The 
constantS cannot contain any unary or binary operators except 
unary plus or unary minus. 
Example 
-G_FLOATING 1000, 1.0E3, 1.0000000E-9 ;constant list 


Notes 


1. G_ floating point numbers are always rounded. They are not 
affected by the .ENABLE TRUNCATION directive. 


2. The floating point constants in the literal list must not be 
preceded by the floating point operator (“F). 
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-GLOBAL 


-GLOBAL -- GLOBAL SYMBOL ATTRIBUTE DIRECTIVE 
-GLOBAL indicates that specified symbol names are either globally 
defined in the current module or externally defined in another module 
(see Section 3.3.3). 
Format 
-GLOBAL symbol-list 
Parameter 
symbol-list 


A list of legal symbol names separated by commas. 


Example 
-GLOBAL LAB 40,LAB_ 30 ; MAKE THESE SYMBOL NAMES 
; GLOBALLY KNOWN 
-GLOBAL UKN_ 13 ; TO ALL LINKED MODULES 
Notes 


1. .GLOBAL is provided for MACRO-11 compatibility only. DIGITAL 
recommends that global definitions be specified by a double 
colon or double equals sign (see Section 2.2.1 and 3.8) and 
that external references be specified by .EXTERNAL (when 
necesSary). 


2. The alternate form of .GLOBAL is .GLOBL. 
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.H_FLOATING 


-H_ FLOATING -- H FLOATING POINT STORAGE DIRECTIVE 
H FLOATING evaluates the specified floating-point constants and stores 
the results in the object module. -H_FLOATING generates 128-bit data 
(1 bit of sign, 15 bits of exponent, and 112 bits of fraction). 
Format 
~H_FLOATING literal-list 
Parameters 
literal-list 
A list of H_ floating point constants (see Section 3.2.2). The 
constants cannot contain any unary or binary operators except 
unary plus or unary minus. 
Example 
«H_ FLOATING © 36912, 15.0E18, 1.0000000E-9 sconstant list 


Notes 


1. H_floating point numbers are always rounded. They are not 
affected by the .ENABLE TRUNCATION directive. 


2. The floating point constants in the literal list must not be 
preceded by the floating point operator (“F). 
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IDENT 


e-IDENT -- IDENTIFICATION DIRECTIVE 


-IDENT provides a means of identifying the object module. This 
identification is in addition to the name assigned to the object 
module with .TITLE. A character string can be specified in .IDENT to 
label the object module. This string is printed in the header of the 
listing file as well as appearing in the object module. 


Format 
-IDENT string 
Parameter 
string 
A 1- to 3i-character string that identifies the module, such as a 
string that specifies a version number. The string must be 
delimited. The delimiters can be any paired printing characters, 
other than the left angle bracket (<) or the semicolon (;), as 
long as the delimiting character is not contained in the text 
string itself. 
Example 
IDENT /3-47/ ; VERSION AND EDIT NUMBERS 
The character string 3-47 is included in the object module. 
Notes 
1. If one source module contains more than one .IDENT, the last 
directive given establishes the character string that forms 
part of the object module identification. 
2. If the delimiting characters do not match, or if an illegal 


delimiting character is used, the assembler displays an error 
message. 
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.IF 


-IF -- CONDITIONAL ASSEMBLY BLOCK DIRECTIVES 


A conditional assembly block is a series of source statements that is 
assembled only if a certain condition is met. -IF starts the 
conditional block and .ENDC ends the conditional block. Each .IF must 
have a corresponding .ENDC. The .IF directive contains a condition 
test and one or two arguments. The condition test specified is 
applied to the argument(s). If the test is met, all MACRO statements 
between .IF and .ENDC are assembled. If the test iS not met, the 
Statements are not assembled. An exception to this occurs when 
subconditional directives are used (see the description of .IF x 
directive). > 


Conditional blocks can be nested, that is a conditional block can be 
inside of another conditional block. In this case the statements in 
the inner conditional block are assembled only if the condition is met 
for both the outer and inner block. 

Format 


-IF condition argument (s) 


- ENDC 
Parameters 
condition 


A specified condition that must be met if the block is to be 
included in the assembly. Table 5-3 lists the conditions that 
can be tested by the conditional assembly directives. The 
condition must be separated from the argument(s) by a comma, 
space, or tab. 


argument (s) 
The symbolic argument(s) or expression(s) of the specified 
conditional test. If the argument is an expression, it cannot 
contain any undefined symbols and must be an absolute expression 
(see Section 3.5). 


range 


The block of source code that is conditionally included in the 
assembly. 
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Table 5-3 
Condition Tests for Conditional Assembly Directives 


Complement Number of | Condition that 
Condition Test Condition Test Argument Type | Arguments | Assembles Block 
Long Short | Long Short 
Form Form Form Form 


EQUAL EQ | NOT_EQUAL NE 
GREATER GT 

LESS THAN | LT 

DEFINED DF 

BLANK + B 

IDENTICAL| IDN 


1. The BLANK, NOT_BLANK, IDENTICAL, and DIFFERENT conditions are only 
useful in macro definitions. Chapter 6 describes macro directives in 
detail. 


























Expression is equal to 


Expression 
0 /not equal to 0 











Expression is greater 
than 0 /less than or 
equal to 0 


Expression 





LESS EQUAL 











Expression is less 
than 0 /greater than 
or equal to 0 


GREATER_EQUAL Expression 
















Symbol is defined /not 
defined 


Symbolic 








NOT_DEFINED 





Argument is blank 
/nonblank 





NOT_BLANK2 Macro 














1 









Arguments are 
identical /different 


DIFFERENT Macro 






Examples 
l. An example of a conditional assembly directive is: 


ASSEMBLE BLOCK IF ALPHA+1=0 
DO NOT ASSEMBLE IF ALPHA+1 NOT=0 


eIF EQUAL ALPHA+1 


=e se 


- ENDC 


2. Nested conditional directives take the form: 


IF condition,argument(s) 
IF condition, argument (s) 
« ENDC 
eENDC 
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3. The following conditional directives can govern’ whether 
assembly is to occur: 


-IF DEFINED SYM1 
IF DEFINED SYM2 


- ENDC 
- ENDC 


In this example, if the outermost condition is not satisfied, no 
deeper level of evaluation of nested conditional statements within the 
program occurs. Therefore, both SYMl and SYM2 must be defined for the 
code to be assembled. 


Notes 


l. If .ENDC occurs outside a conditional assembly block, the 
assembler displays an error message. 


2. VAX-11 MACRO permits a nesting depth of 31 #£conditional 
assembly levels. If a statement attempts to exceed this 
nesting level depth, the assembler displays an error message. 


3. The assembler displays an error message if .IF specifies any 
of the following: a condition test other than those in Table 
5-3, an illegal argument, or a null argument specified in an 
-IF directive. 


4. The .SHOW and .NOSHOW directives control whether condition 
blocks that are not assembled are included in the listing 
file. 
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.IF_x 


~IF_x -- SUBCONDITIONAL ASSEMBLY BLOCK DIRECTIVES 
VAX-11 MACRO has three subconditional assembly block directives: 
Directive Function 


-IF_ FALSE If the condition of the assembly block tests 
false, the program is to include the source code 
following the .IF FALSE directive and continuing 
up to the next subconditional directive or to the 
end of the conditional assembly block. 


-IF_ TRUE If the condition of the assembly block tests true, 
the program is to include the source code 
following the .IF TRUE directive and continuing up 
to the next subconditional directive or to the end 
of the conditional assembly block. 


-IF_ TRUE FALSE Always include the source code following the 
a -IF_TRUE FALSE directive and continuing up to the 
next subconditional directive or to the end of the 
conditional assembly block. This source code is 
included regardless of whether the condition of 
the assembly block tests true or false, 


The implied argument of a subconditional directive is the condition 
test specified when the conditional assembly block was entered. A 
conditional or subconditional directive in a nested conditional 
assembly block is not evaluated if the preceding (or outer) condition 
in the block is not satisfied (see examples 3 and 4 below). 


A conditional block with a subconditional directive is different than 
a nested conditional block. If the condition in the .IF is not met, 
the inner conditional block(s) are not assembled, but a subconditional 
directive can cause a block to be assembled. 


Formats 
~IF FALSE 


.IF_TRUE 
.IF_TRUE_FALSE 


Examples 


l. 
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Assume that symbol SYM is defined: 


-IF DEFINED SYM 


.IF_FALSE 


.IF_TRUE 


~IF_ TRUE FALSE 


. IF_TRUE 


» ENDC 


e 
a 
° 
t 


=e sme =e Se “08 


=e te 


me te Me 


TESTS TRUE SINCE SYM IS DEFINED. 
ASSEMBLES THE FOLLOWING CODE. 


TESTS FALSE SINCE PREVIOUS 
~IF WAS TRUE. DO NOT 
ASSEMBLE THE FOLLOWING CODE. 


TESTS TRUE. SYM IS DEFINED. 
ASSEMBLES THE FOLLOWING CODE. 


ASSEMBLES FOLLOWING CODE 
UNCONDITIONALLY. 


TESTS TRUE. SYM IS DEFINED. 
ASSEMBLES REMAINDER OF 
CONDITIONAL ASSEMBLY BLOCK. 


Assume that symbol X is defined and that symbol Y is not defined: 


e-IF DEFINED X 
-IF DEFINED Y 


.IF_FALSE 


.IF_TRUE 


» ENDC 
» ENDC 


me “@ “oe Be NO Me 


=e 6“ Ne MO 


TESTS TRUE. SYMBOL X IS DEFINED. 
TESTS FALSE. SYMBOL Y IS NOT 
DEFINED. 

TESTS TRUE. SYMBOL Y IS NOT 
DEFINED. 

ASSEMBLES THE FOLLOWING CODE. 


TESTS FALSE. SYMBOL Y IS NOT 
DEFINED. 

DOES NOT ASSEMBLE THE FOLLOWING 
CODE. 


Assume that symbol A is defined and that symbol B is not defined: 


-IF DEFINED A 


.IF_FALSE 


.IF NOT DEFINED B 


» ENDC 
- ENDC 


° 
e 
° 
’ 


me ™e 


me Me 


TESTS TRUE. A IS DEFINED. 
ASSEMBLES THE FOLLOWING CODE. 


TESTS FALSE. A IS DEFINED. DOES 
NOT ASSEMBLE THE FOLLOWING CODE. 


NESTED CONDITIONAL DIRECTIVE 
IS NOT EVALUATED. 
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4. Assume that symbol X is not defined but symbol Y is defined: 


TESTS FALSE. SYMBOL X IS NOT 
DEFINED. 

DOES NOT ASSEMBLE THE 
FOLLOWING CODE. 

NESTED CONDITIONAL DIRECTIVE 
IS NOT EVALUATED. 


~IF DEFINED X 


~IF DEFINED Y 


=e me MO TO NO TNO 


-IF_FALSE ; NESTED SUBCONDITIONAL 

. ; DIRECTIVE IS NOT EVALUATED. 
-IF_TRUE ; NESTED SUBCONDITIONAL 

° ; DIRECTIVE IS NOT EVALUATED. 
- ENDC 
» ENDC 


If a subconditional directive appears outside a conditional 
assembly block, the assembler displays an error message. 


The alternate forms of ~IF_ FALSE, -IF_ TRUE, | and 
.IF_TRUE FALSE are .IFF, .IFT, and .IFTF. 
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LIF 


.IIF -- IMMEDIATE CONDITIONAL ASSEMBLY BLOCK DIRECTIVE 
-IIF provides a means of writing a one-line conditional assembly 
block. The condition to be tested and the conditional assembly block 
are expressed completely within the line containing the ~IIF 
directive; no terminating .ENDC statement is required. 
Format 
-IIF condition argument(s), statement 
Parameters 
condition 
One of the legal condition tests defined for conditional assembly 
blocks in Table 5-3 (See the description of .IF). The condition 
must be separated from the argument(s) by a comma, space, or tab. 
argument (s) 
The argument associated with the immediate conditional directive; 
that is, an expression or symbolic argument (described in Table 
5-3). If the argument is an expression, it cannot contain any 
undefined symbols and must be an absolute expression (see Section 
3.3.3). The argument(s) must be separated from the statement by 
a comma. : 
statement 
The statement to be assembled if the condition is satisfied. 
Example 
Condition Argument Statement 


~I[IF DEFINED EXAM, BEQL ALPHA 


This directive generates the following code if the symbol EXAM is 
defined within the source program: 


BEQL ALPHA 
Note 
The assembler displays an error message if .IIF specifies any of 


the following: a condition test other than those listed in Table 
5-3, an illegal argument, or a null argument. 
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-LIST 


eLIST -- LISTING DIRECTIVE 


-LIST is equivalent to the .SHOW. See the description of .SHOW for 
more information. 


Formats 


~LIST 
~LIST argument-list 


Parameter 

argument-list 
One or more of the symbolic argument defined in Table 5-7 in’ the 
description of .SHOW. Either the long form or the short form of 


the arguments can be used. If multiple arguments are specified, 
they must be separated by commas, spaces, or tabs. 
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-LONG 


«LONG ~- LONGWORD STORAGE DIRECTIVE 


~-LONG generates successive longwords (4 bytes) of data in the object 
module. 


Format 
-LONG expression-list 

Parameters 

expression-list 
One or more expressions separated by commas. Each expression 
optionally can be followed by a repetition factor delimited by 
Square brackets. 
An expression followed by a repetition factor has the format: 

expressionl [expression2] 

expressionl 
An expression that specifies the value to be stored. 

[expression2] 
An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 

Example 

LAB 3: ~ LONG LAB_3,°X7FFFFFFF,°A'ABCD' 3 LONGWORDS OF DATA 


- LONG “XF@4 ; 1 LONGWORD OF DATA 
- LONG 0[22] ; 22 LONGWORDS OF DATA 


Note 


Each expression in the list must have a value that can be 
represented in 32 bits. 
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.MASK 


-MASK -~- MASK DIRECTIVE 


-MASK reserves a word for a register save mask for a transfer vector. 


See the 


description of .TRANSFER for more information and for an 


example of .MASK. 


Format 


-MASK symbol[,expression] 


Parameters 


symbol 


A symbol defined in an .ENTRY directive. 


expression 


A register save mask. 


Notes 


l. 


If .MASK does not contain an expression, the assembler 
directs the linker to copy the register save mask specified 
in .ENTRY to the word reserved by .MASK. 


If .MASK contains an expression, the assembler directs’ the 
linker to combine this expression with the register save mask 
specified in .ENTRY and store the result in the word reserved 
by .MASK. The linker performs an inclusive OR operation to 
combine the mask in the entry point and the value of the 
expression. Consequently, a register specified in either 
~ENTRY or .MASK will be included in the combined mask. See 
the description of .ENTRY for more information on entry 
masks. 


.NLIST 


eNLIST -- LISTING DIRECTIVE 


-NLIST is equivalent to .NOSHOW. See the description of .SHOW for 
more information. 


Formats 


eNLIST 
-NLIST argument-list 


Parameter 


argument-list 


One or more of the symbolic arguments listed in Table 5-7 in’ the 
description of .SHOW. Either the long form or the short form of 
the arguments can be used. If multiple arguments are specified, 
they must be separated by commas, spaces, or tabs. 
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-NOCROSS 


e-NOCROSS -- CROSS REFERENCE DIRECTIVE 

VAX-11 MACRO produces a cross-reference listing when the CROSS 
qualifier is specified in the MACRO command. The .CROSS and .NOCROSS 
directives control which symbols are included in the cross-reference 
listing. The description of .NOCROSS is included with the description 
of .CROSS. 

Formats 


.NOCROSS 
-NOCROSS symbol-list 


Parameter 
symbol-list 


A list of legal symbol names separated by commas. 


.NOSHOW 


e-NOSHOW -- LISTING DIRECTIVE 


~-NOSHOW specifies listing control options. See the description of 
~-SHOW for more information. 


Formats 


' ~.NOSHOW 
-NOSHOW argument-list 


Parameter 

argument-list 
One or more of the symbolic arguments listed in Table 5-7 in the 
description of .SHOW. Either the long form or the short form of 


the arguments can be used. If multiple arguments are specified, 
they must be separated by commas, spaces, or tabs. 
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-OCTA 


-OCTA -- OCTAWORD STORAGE DIRECTIVE 
-OCTA generates 128 bits (16 bytes) of binary data. 
Format 


-OCTA literal 
-OCTA symbol 


Parameters 

literal 
Any constant value. This value can be preceded by “O, “B, “X, or 
“D to specify the radix as octal, binary, hexadecimal, or 
decimal, respectively; or it can be preceded by “A to_ specify 
ASCII text. Decimal is the default radix. 

symbol 


A symbol defined elsewhere in the program. This symbol results 
in a sign-extended, 32-bit value being stored in an octaword. 


Example 
~OCTA “A" FEDCBA987654321" EACH ASCII CHARACTER IS STORED 
IN A BYTE 
-OCTA 0 OCTA 0 


OCTA HEX VALUE SPECIFIED 
VINTERVAL HAS A 32 BIT VALUE 
SIGN EXTENDED 


-OCTA %*X01234ABCD5678F9 
-OCTA VINTERVAL 


we “6 we “Oe “OS NO 


Note 
-OCTA is like .QUAD and unlike other data storage directives 
(.BYTE, -WORD, and .LONG) in that it does not evaluate 


expressions and that it accepts only one value. It does not 
accept a list. 


-ODD 


-ODD -- ODD LOCATION COUNTER ALIGNMENT DIRECTIVE 

-ODD ensures that the current value of the location counter is odd by 
adding 1 if the current value is even. If the current value is 
already odd, no action is taken. 


Format 


- ODD 
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.OPDEF 


-OPDEF -- OPCODE DEFINITION DIRECTIVE 


-OPDEF defines an opcode, which it inserts into a user-defined 


opcode 


table. The assembler searches this table before it searches the 


permanent symbol table. This directive can redefine an 
opcode name or create a new one. 


Format 

~OPDEF opcode value, operand-descriptor-list 
Parameters 
opcode 


An ASCII string specifying the name of the opcode. The 


existing 


string 


can be up to 31 characters long and can contain the letters A 
through Z; the digits 0 through 9; and the special characters 
underline (_), dollar sign (S$), and period (.). The string 
Should not start with a digit and should not be surrounded by 


delimiters. 


value 


An expression that specifies the value of the opcode. 


The 


expression must not contain any undefined values and must be an 


absolute expression (see - Section 3.5). The value 


the 


expression must be in the range of 0 through decimal 65535 
(hexadecimal FFFF), but the values 252 through 255 cannot _ be 


used. The expression is represented as follows: 


if 0 < expression <¢ 251 expression is a one-byte opcode. 


if expression > 255 expression bits 15:8 


are the 


first byte of the opcode and 


expression bits 7:0 are 
second byte of the opcode. 


the 


Values 252 through 255 cannot be used because the architecture 
specifies these as the start of a two-byte opcode. Note that 
this representation does not correspond to the representation of 


these numbers in memory. 


operand-descriptor-list 


A list of operand descriptors that specifies the number of 
operands and the type of each. Up to 16 operand descriptors are 
allowed in the list. Table 5-4 lists the operand descriptors. 
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Table 5-4 
Operand Descriptors 








Data Type 








Access Floating| Double G_ floating | H_floating | Quad- | Octa- 
Type Floating | Point Point word word 


AH 











Address 
Read-only RH 
Modify MH 


WH 


Write-only 


Field VH 


Branch 











Examples 
-OPDEF MOVL3 “XFFA9 ,RL,ML ,WL ; DEFINES AN 
; INSTRUCTION, MOVL3, WHICH USES 
* THE RESERVED OPCODE FF. 
-OPDEF DIVF2 “X46,RF,MF ; REDEFINES THE DIVF2 AND 
~OPDEF MOVCS5 “X2C,RW,AB,AB,RW,AB ; MOVC5 INSTRUCTIONS. 
-OPDEF CALL *X10,BB ; EQUIVALENT TO A BSBB 
Notes 


l. A macro can also be used to redefine an opcode (see the 
description of .MACRO in Chapter 6). Note that the macro 
name table is searched before the user-defined opcode table. 


2. .OPDEF is useful in creating "custom" instructions’ that 
execute usér-written microcode. This directive is supplied 
to allow programmers to execute their microcode in a MACRO 
program. 


3. The operand descriptors are specified in a format similar to 
the operand specifier notation described in the VAX-11 
Architecture Handbook. The first character specifies’ the 
operand access type and the second character specifies the 
operand data type. 
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.PACKED 


-PACKED -- PACKED DECIMAL STRING STORAGE DIRECTIVE 
-PACKED generates packed decimal data, 2 digits per byte. Packed 
decimal data is useful in calculations requiring exact accuracy. 
Packed decimal data is operated on by the decimal string instructions. 
See the VAX-1l1 Architecture Handbook for more information on the 
format of packed decimal data. 
Format 
»-PACKED decimal-string[,symbol] 
Parameters 
decimal-string 
A decimal number from 0 through 31 digits long with an _ optional 
Sign. Each digit can be in the range of 0 through 9 (see Section 
3u2e3)s 
symbol 
An optional symbol that is assigned a value equivalent to the 


number of decimal digits in the string. The sign is not counted 
as a digit. 


Example 
-PACKED -12,PACK_SIZE : PACK_SIZE GETS VALUE OF 2 
»~PACKED +500 
ePACKED 0 
«PACKED -0,SUM_SIZE ; SUM_SIZE GETS VALUE OF 1 


-PAGE 


-PAGE -- PAGE EJECTION DIRECTIVE 


-PAGE forces a new page in the listing; the directive itself is not 
printed in the listing. 


VAX-11 MACRO ignores .PAGE in a macro definition. The paging 
operation is performed only during macro expansion. Chapter 6 
describes macro directives and facilities in detail. 


Format 


-PAGE 
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.PRINT 


-PRINT -- ASSEMBLY MESSAGE DIRECTIVE 


~-PRINT causes the assembler to display an informational message. The 
message consists of the value of the expression and the comment 
specified in the .PRINT directive. The message is displayed on _ the 
terminal for interactive jobs and in the log file for batch jobs. The 
message produced by .PRINT is not considered an error or _ warning 
message. 


Format 

-PRINT [expression] ;comment 
Parameters 
expression 


An expression whose value is displayed when .PRINT is encountered 
during assembly. 


comment 


A comment that is displayed when .PRINT is encountered during 
assembly. The comment must be preceded by a semicolon. 


Example 
»-PRINT 2 ; THE SINE ROUTINE HAS BEEN CHANGED 
Notes 


1. .PRINT, .ERROR, and .WARN are called the message display 
directives. They can be used to display information 
indicating that a macro call contains an error or an illegal 
set of conditions (See Chapter 6 for more information on 
Macro calls). 


2. If .PRINT is included in a macro library (see the VAX-1l 
MACRO User's Guide), the comment should end with an 
additional semicolon. Otherwise, the comment will be 
Stripped from the directive and will not be displayed when 
the macro is called. 


3. If the expression has a value of 0, it is not displayed with 
the message. 
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-PSECT ~- PROGRAM SECTIONING DIRECTIVE 


~-PSECT defines a program section and its attributes and refers to a 
program section once it is defined. 


Program sections can be used to: 
e Develop modular programs 
e Separate instructions from data 
e Allow different modules to access the same data 
e Protect read-only data and instructions from being modified 
e Identify sections of the object module to the debugger 


e Control the order in which program sections are stored in 
virtual memory 


See the VAX-1]1 MACRO User's Guide for more information on using 
program sections. 


The assembler automatically defines two program’ sections: the 
absolute program section and the unnamed (or blank) program section. 
Any symbol definitions that appear before any instruction, data, or 
~-PSECT directive are placed in the absolute program section. Any 
instructions or data that appear before the first named _ program 
section is defined are placed in the unnamed program section. Any 
-PSECT directive that does not include a program section name 
specifies the unnamed program section. 


A maximum of 254 user-defined, named program sections can be defined. 


When the assembler encounters a .PSECT directive that specifies a new 
program section name, it creates a new program section and stores the 
name, attributes, and alignment of the program section. The assembler 
includes all data and instructions that follow the .PSECT directive in 
that program section until it encounters another .PSECT directive. 
The assembler starts all program sections at a location counter of 0 
which is relocatable. 


If the assembler encounters a .PSECT directive that specifies the name 
of a previouSly defined program section, it stores the new data or 
instructions after the last entry in the previously defined program 
section. The location counter is set to the value of the location 
counter at the end of the previously defined program. section. The 
programmer need not list the attributes when continuing a program 
section but any attributes that are listed must be the same as_ those 
previously in effect for the program section. A continuation of a 
Program section cannot contain attributes conflicting with those 
specified in the original .PSECT directive. 


The attributes listed in the .PSECT directive only describe the 
contents of the program section. The assembler does not check to 
ensure that the contents of the program section actually include’ the 
attributes listed. 
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However, the assembler and the linker do check that all program 
sections with the same name have exactly the same attributes. The 
assembler and linker display an error message if the program section 
attributes are not consistent. 


Program section names are independent of local symbol, global symbol, 
and macro names. Thus, the same symbolic name can be used for a 
program section and for a local symbol, global symbol, or macro name. 


Formats 


-PSECT 
-PSECT program section-name[,argument-list] 


Parameters 
program-section-name 


The name of the program section. This name can be up to 3l 
characters long and can contain any alphanumeric character and 
the underline ( ), dollar sign ($), and period (.) characters. 
However, the first character must not be a digit. 


argument-list 


A list containing the program section attributes and the program 
section alignment. Table 5-5 lists the attributes and their 
functions. Table 5-6 lists the default attributes and _ their 
opposites. Program sections are aligned when an integer in the 
range of 0 through 9 is specified or when one of the _ five 
keywords listed below is specified. If an integer is specified, 
the program section is linked to begin at the next virtual 
address that is a multiple of 2 raised to the power of the 
integer. If a keyword is specified, the program section is 
linked to begin at the next virtual address that is a multiple of 
the values listed below: 


Keyword Size (in Bytes) 


BYTE 2 
WORD 2° 
LONG a 
QUAD 2° 
PAGE 2 


WOPN 


BYTE is the default. 
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Table 5-5 
Program Section Attributes 













Attribute Function 


Name 










Absolute--The linker assigns the program section an 
absolute address. The contents of the _ program 
section can be only symbol definitions (usually 
definitions of symbolic offsets to data structures 
that are used by the routines being assembled). An 
absolute program section contributes no binary code 
to the image, so its byte allocation request to the 
linker is 0. The size of the data structure being 
defined is the size of the absolute program section 
printed in the "program section synopsis" at the end 
of the listing. Compare this attribute with its 
opposite, REL. 















Concatenate--Program sections with the same name _ and 
attributes (including CON) are merged into one 
program section. Their contents are merged in the 
order in which the linker acquires’ them. The 
allocated virtual address space is the sum of the 
individual requested allocations. 










Executable--The program section contains 
instructions. This attribute provides the capability 
of separating instructions from read-only and 
read/write data. The linker uses this attribute in 
gathering program sections and in verifying that the 
transfer address is in an executable program section. 










Global--Program sections that have the same name and 
attributes, including GBL and OVR, will have the same 
relocatable address in memory even when the _ program 
sections are in different clusters (see the VAX-1ll 
Linker Reference Manual for more information on 
clusters). This attribute is specified for FORTRAN 
COMMON block program sections (see the VAX-11 FORTRAN 
User's Guide). Compare this attribute with its 
opposite, LCL. 










Local--The program section is restricted to its 
cluster. Compare this attribute with its opposite, 
GBL. 








Library Segment--Reserved for future use. 





Not Executable--The program section contains data 
only; it does not contain instructions. 






Non-Position-Independent Content--The program section 
is assigned to ae fixed location in virtual memory 
(when it is in a shareable image). 







Nonreadable--Reserved for future use. 






No Share--The program section is reserved for private 
use at execution time by the initiating process. 


me ree erm ast tr eg pete OER: om te RN ASMA ehh nnn nnn tect em ppannsantee arene emt rer terrae tr 


(continued on next page) 





Attribute 
Name 
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Table 5-5 (Cont.) 
Program Section Attributes 


Function 


Nonwritable--The program section's contents cannot be 
altered (written into) at execution time. 


Overlay--Program sections with the same name _ and 
attributes, including OVR, have the same relocatable 
base address in memory. The allocated virtual 
address space is the requested allocation of the 
largest overlaying program section. Compare this 
attribute with its opposite, CON. 


Position-Independent Content--The program section can 
be relocated; that is, it can be assigned to any 
memory area (when it is in a shareable image). 


Readable--Reserved for future use. 


Relocatable--The linker assigns the program section a 
relocatable base address. The contents of the 
program section can be code or data. Compare this 
attribute with its opposite, ABS. 


Share--The program section can be shared at execution 
time by multiple processes. This attribute is 
assigned to a program section that can be linked into 
a shareable image. 


User Segment--Reserved for future use. 
Vector-Containing--The program section contains a 
change mode vector indicating a privileged shareable 


image. The SHR attribute must be used with VEC. 


Write--The program section's contents can be altered 
(written into) at execution time. 


Table 5-6 
Default Program Section Attributes 


Default Opposite 
Attribute Attribute 
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Examples 


~PSECT CODE,NOWRT,EXE, LONG PROGRAM SECTION TO CONTAIN 


EXECUTABLE CODE 


me MO 


-PSECT RWDATA,WRT,NOEXE,QUAD 
PROGRAM SECTION TO CONTAIN 
MODIFIABLE DATA 


=e te 


Notes 


1. The .ALIGN directive cannot specify an alignment greater than 
that of the current program section; consequently, .PSECT 
should specify the largest alignment needed in the _ program 
section. For efficiency of execution, an alignment of 
longword or larger is recommended for all program’ sections 
that have longword data. 


2. The attributes of the default absolute and the default 
unnamed program sections are listed below. Note that the 
program section names include the periods and enclosed 
spaces. 


Program Section 


Name Attributes and Alignment 
- ABS. NOPIC,USR,CON,ABS, LCL,NOSHR,NOEXE,NORD,NOWRT ,NOVEC ,BYTE 
- BLANK . NOPIC,USR,CON,REL,LCL,NOSHR,NOEXE,RD,WRT,NOVEC ,BYTE 
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-QUAD 


eQUAD -- QUADWORD STORAGE DIRECTIVE 


-QUAD generates 64 bits (8 bytes) of binary data. 


Format 


eQUAD literal 
~QUAD symbol 


Parameters 


literal 


Any constant value. This value can be preceded by “O, “B, “X, or 
“D to specify the radix as octal, binary, hexadecimal, or 
decimal, respectively; or it can be preceded by “A to specify 
the ASCII text operator. Decimal is the default radix. 


symbol 


A symbol defined elsewhere in the program. This symbol results 
in a sign-extended, 32-bit value being stored in a quadword. 


Example 


Note 


- QUAD A? 6 eASK? oa" EACH ASCII CHARACTER IS STORED 
IN A BYTE 

QUAD 0 

QUAD HEX VALUE SPECIFIED 

QUAD BINARY VALUE SPECIFIED 
LABEL HAS A 32 BIT 


VALUE ZERO EXTENDED. 


- QUAD 0 

-QUAD *X0123456789ABCDEF 
- QUAD *B1111000111001101 
- QUAD LABEL 


™e te SO MO MO NO NO 


-QUAD is like .OCTA and different from other data _ storage 
directives (.BYTE, .WORD, and .LONG) in that it does not evaluate 
expressions and that it accepts only one value. It does not 
accept a list. 
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.REFn 
e-REFn -- OPERAND GENERATION DIRECTIVES 
VAX-11 MACRO has five operand generation directives used in macros 
(see Chapter 6) to define new opcodes: 
Directive Function 
-REF1 Generates a byte operand 
»REF2 Generates a word operand 
»REF4 Generates a longword operand 
~REF8 Generates a quadword operand 
-REF16 Generates an octaword operand 
The .REFn directives are provided for compatibility with VAX-1l MACRO 


V1.0. The .OPDEF directive provides greater functionality and is 
easier to use than .REFn; consequently, .OPDEF should be used instead 
of .REFn. . 
Formats 

~-REF1 operand 

~-REF2 operand 

~-REF4 operand 

~-REF8 operand 


~-REF16 operand 


Parameter 
operand 
An operand of byte, word, longword, quadword, or octaword 
context, respectively. 
Example 
»-MACRO MOVL3 A,B,C 
»-BYTE “XFF ,~XA9 
»REF4 A ; THIS OPERAND HAS LONGWORD CONTEXT 
»REF4 B ; THIS OPERAND HAS LONGWORD CONTEXT 
»REF4 C ; THIS OPERAND HAS LONGWORD CONTEXT 
~ENDM MOVL3 
MOVL3 RO, @LAB-1, (R7)+{R10] 


This example uses .REF4 to create a new instruction, MOVL3, which uses 


the reserved 


opcode 


FF. 


method to create a new instruction. 


See the example in .OPDEF for a preferred 
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-RESTORE PSECT -- RESTORE PREVIOUS PROGRAM SECTION CONTEXT DIRECTIVE 


»-RESTORE PSECT retrieves the program section from the top of the 
program Section context stack, an internal stack in the assembler. If 
the stack is empty when .RESTORE PSECT is issued, the assembler 
displays an error message. When .RESTORE PSECT retrieves a program 
section, it restores the current location counter to the value it had 
when the program section was saved. The local label block is also 
restored if it was saved when the program section was saved. See_ the 
description of .SAVE_PSECT. 


Format 
-RESTORE PSECT 
Example 


-RESTORE PSECT and .SAVE PSECT are especially useful in macros 
that define program Sections (see Chapter 6). The macro 
definition below saves the current program section context and 
defines new program’ sections. Then, it restores the saved 
program section. If the macro did not save and restore the 
program section context each time the macro was invoked, the 
program section would change. 


INITIALIZE SYMBOLS 

AND DATA AREAS 

SAVE THE CURRENT PSECT 
DEFINE NEW PSECT 
DEFINE SYMBOLS 


eMACRO- INITD 


.SAVE_PSECT 
-PSECT SYMBOLS,ABS 
HELP LEV=2 
MAXNUM=100 
RATE1=16 
RATE2=4 


DEFINE ANOTHER PSECT 
100 LONGWORDS IN TABL 
MORE STORAGE 

RESTORE THE PSECT 

IN EFFECT WHEN 

MACRO IS INVOKED 


~PSECT DATA,NOEXE,LONG 
TABL: .BLKL 100 
TEMP:  .BLKB 16 
»RESTORE_PSECT 


me Me %e MO MO MO MO Ne MO MO Me TO NO WO 


- ENDM 
Note 


The alternate form of -RESTORE_ PSECT is .~RESTORE. 


GENERAL ASSEMBLER DIRECTIVES 
.SAVE_PSECT 


-SAVE PSECT -- SAVE CURRENT PROGRAM SECTION CONTEXT DIRECTIVE 


-SAVE PSECT stores the current program section context on the top of 
the program section context stack, an internal assembler stack, while 
leaving the current program section context in effect. The program 
section context stack can hold 31 entries. Each entry includes the 
value of the current location counter and the maximum value assigned 
to the location center in the current program section. If the stack 
is full when .SAVE _PSECT is encountered, an error occurs. 


~SAVE_PSECT and .RESTORE_ PSECT are especially useful in macros’ that 
define program sections (sée Chapter 646). See the description of 
-RESTORE PSECT for another example of using .SAVE_PSECT. 
Format 

~SAVE_ PSECT [LOCAL_BLOCK] 
Parameter 


LOCAL_BLOCK 


An optional keyword that specifies that the current local label 
is to be saved with the program section context. 


Example 


MACRO DEFINITION: 


.-MACRO ERR MESSAGE, TEXT : SET UP LISTS OF MESSAGES AND 
~~ > POINTERS 

-IIF NOT DEFINED MESSAGE INDEX, MESSAGE INDEX=0_ ; 

~SAVE PSECT LOCAL BLOCK ™~: KEEP LOCAL LABELS 

~-PSECT MESSAGE TEXT ; LIST OF ERROR MESSAGES 


MESSAGE:: .ASCIC /TEXT/ 


»-PSECT MESSAGE POINTERS ADDRESSES OF ERROR MESSAGES 


A 
-ADDRESS “MESSAGE : STORE ONE POINTER 
~RESTORE PSECT ; GET BACK LOCAL LABELS 
PUSHL — #MESSAGE INDEX ; 
CALLS #1, PRINT MESS ; PRINT MESSAGE 


MESSAGE INDEX=MESSAGE_INDEX+1 
-ENDM ERR_MESSAGE 


MACRO CALL: 


RESETS: CLRL R4 ; 
BLBC RO, 308 7 
ERR_MESSAGE <STRING TOO SHORT> ; ADD "STRING TOO SHORT" 


: TO LIST OF ERROR MESSAGES 
30S: RSB 


The use of .SAVE PSECT LOCAL BLOCK here means that the local label 30S 
is defined in the same local label block as the reference to 30S. If 
a local label is not defined in the block in which it is’ referenced, 
the assembler produces the following error message: 

%MACRO-E-UNDEFSYM, Undefined Symbol 
Note 


sl he The alternate form of ~SAVE PSECT is .SAVE. 
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SHOW 
.NOSHOW 


-SHOW AND .NOSHOW -- LISTING DIRECTIVES 


~SHOW and .NOSHOW specify listing control options in the source text 
of a program. ~SHOW and .NOSHOW can be used with or without an 
argument list. 


When used with an argument list, .SHOW causes certain types of lines 
to be included in the listing file and .NOSHOW causes certain types of 
lines to be excluded. .SHOW and .NOSHOW control the listing of the 
source lines that are in conditional assembly blocks (see the 
description of .IF), macros, and repeat blocks (see Chapter 6). 


When used without arguments, these directives alter the listing level 
count. The listing level count is initialized to 0. Each time .SHOW 
appears in a program, the listing level count is incremented; each 
time .NOSHOW appears in a program, the listing level count is 
decremented. 


When the listing level count is negative, the listing is suppressed 
(unless the line contains an error). Conversely, when the listing 
level count is positive, the listing is generated. When the count is 
0, the line is either listed or suppressed, depending on the value of 
the listing control symbolic arguments. 


Formats 


- SHOW 

-SHOW argument-list 
-NOSHOW 

-NOSHOW argument-list 


Parameter 
argument-list 


One or more of the optional symbolic arguments, defined in Table 
5-7. Either the long form or the short form of the arguments can 
be used. Each argument can be used alone or in combination with 
other arguments. If multiple arguments are specified, they must 
be separated by commas, tabs, or spaces. If any argument is not 
specifically included in a listing control statement, its default 
value (Show or Noshow) is assumed throughout the source program. 
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Table 5-7 
-SHOW and .NOSHOW Symbolic Arguments 


BINARY Noshow Lists macro expansions and 
repeat block expansions 
that generate binary code. 
BINARY is a subset of 
EXPANSIONS. 


CALLS Lists macro calls and 
repeat block specifiers. 


CONDITIONALS Lists unsatisfied 
conditional code 
associated with the 
conditional assembly 
directives. 





DEFINITIONS Lists macro and repeat 
range definitions that 
appear in an.input source 
file. 
EXPANSIONS Noshow Lists macro and repeat 
range expansions. 
Example 
eMACRO XX 
- SHOW ; LIST NEXT LINE. 
X=. 
-NOSHOW ; DO NOT LIST REMAINDER OF MACRO 
° ; EXPANSION. 
» ENDM 
e-NOSHOW EXPANSIONS ; DO NOT LIST MACRO EXPANSIONS. 
XX 
X=. 
Notes 


1. The listing level count allows macros to be listed 
selectively; a macro definition can specify .NOSHOW at the 
beginning to decrement the listing count and can specify 
-SHOW at the end to restore the listing count to its original 
value. 


2. The alternate forms of .SHOW and .NOSHOW are .LIST and 
-NLIST. 
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.SIGNED_BYTE 


~SIGNED_ BYTE -- SIGNED BYTE DATA DIRECTIVE 
~SIGNED BYTE is equivalent to .BYTE, except that VAX-11 MACRO 
indicates that the data is signed in the object module. The linker 
uses this information to test for overflow conditions. 
Format 
-SIGNED BYTE expression-list 
Parameters 
expression-list 
An expression or list of expressions separated by commas. Each 
expression optionally can be followed by a repetition factor 
delimited by square brackets. 
An expression followed by a repetition factor has the format: 
expressionl [expression2] 


expressionl 


An expression that specifies the value to be stored. The value 
must be in the range -128 to +127. 


[expression2] 
An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 

Example 


~SIGNED BYTE LABEL1-LABEL2 
~SIGNED BYTE ALPHA[ 20] 


DATA MUST FIT 
IN BYTE 


~e tO 


Note 


Specifying .SIGNED BYTE allows the linker to detect overflow 
conditions when the value of the expression is in the range of 
128 through 255. Values in this range can be stored as'- unsigned 
data but cannot be stored as signed data in a byte. 
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-SIGNED_ WORD 


-SIGNED WORD -- SIGNED WORD STORAGE DIRECTIVE 
-SIGNED WORD is equivalent to .WORD except that the assembler 
indicates that the data is signed in the object module. The linker 
uses this information to test for overflow conditions. «SIGNED WORD 
is useful after the case instruction to ensure that the displacement 
fits in a word. 
Format 
«SIGNED WORD expression-list 
Parameters 
expression-list 
An expression or list of expressions separated by commas. Each 
expression optionally can be followed by a repetition factor 
delimited by square brackets. 
An expression followed by a repetition factor has the format: 
expressionl [expression2] 


expressionl 


An expression that specifies the value to be stored. The value 
must be in the range -32768 to +32767. 


[expression2] 
An expression that specifies the number of times the value will 
be repeated. The expression must not’ contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 


Example 


-MACRO CASE,SRC,DISPLIST,TYPE=W, LIMIT=#0,NMODE=S°#, ?BASE, ?MAX 
MACRO TO USE CASE INSTRUCTION 


=e te Me TO 


; VALUE OF SELECTOR 
CASE'TYPE SRC ,LIMIT,NMODE' <<MAX-BASE>/2>-1 
CASE INSTRUCTION 
LOCAL LABEL SPECIFYING BASE 
TO SET UP OFFSET LIST 
OFFSET LIST 


BASE: 
- IRP EP,<DISPLIST> 
~SIGNED WORD EP-BASE 
-ENDR 


MAX : LOCAL LABEL USED TO COUNT ARGS 


me ™e SNe Se Ve Ne Bs 


- ENDM CASE 


SRC IS SELECTOR, DISPLIST IS LIST 
OF DISPLACEMENTS, TYPE IS B-BYTE 
W-WORD, L-LONG, LIMIT IS THE BASE 


CASE IVAR <ERR PROC,SORT,REV SORT> ; IF IVAR=0, ERROR; 


CASEW IVAR, #0,S~#<<30001$-30000$5/2>-1 


300008: 
~SIGNED WORD 
-SIGNED WORD 
-SIGNED WORD 
300018: ~ 


CASE TEST 


30002: 
-SIGNED_WORD 
-SIGNED WORD 
~SIGNED WORD 

30003S: 
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ERR_PROC-30000$ 
SORT-30000$ 
REV_SORT-30000$ 


=e 


e 
a 
° 
’ 


LOCAL LABEL SPECIFYING BASE 

; OFFSET LIST 

; OFFSET LIST 

; OFFSET LIST 
LOCAL LABEL USED TO COUNT ARGS 
=1, FOWARD SORT; =2,BACKWARD SORT 


<TEST1,TEST2,TEST3>,L,#1 : 
CASEL TEST, #1,S~#<<30003S-300025>/2>-1 


TEST1-30002$ 
TEST2-30002$ 
TEST3-30002$ 


t 


e 
’ 
e 
a 


LOCAL LABEL SPECIFYING BASE 

; OFFSET LIST 

; OFFSET LIST 

; OFFSET LIST 
LOCAL LABEL USED TO COUNT ARGS 
VALUE OF TEST CAN BE 1,2, OR 3 


In this example, the CASE macro uses -SIGNED WORD to create a CASEB, 


CASEW, or CASEL instruction. 


directives used to define the macro. 


Note 


Specifying .~.SIGNED WORD allows 


the 


See Chapter 6 for a description of the 


linker to detect overflow 


conditions when the value of the expression is in the range of 
32768 through 65535. Values in this range can be stored as 
unsigned data but cannot be stored as signed data in a word. 


GENERAL ASSEMBLER DIRECTIVES 


SUBTITLE 


eSUBTITLE -- SUBTITLE DIRECTIVE 


~SUBTITLE causes the assembler to print a line of text in the table of 
contents that is produced immediately before the assembly listing. 
The assembler also prints the line of text as the subtitle on _ the 
second line of each assembly listing page. This subtitle text is 
printed on each page until altered by a subsequent .SUBTITLE directive 
in the program. 


Format 
-SUBTITLE comment-string 

Parameter 

comment-string 
An ASCII string from 1 to 40 characters long; excess’ characters 
are truncated. This string represents the line of text to be 
printed in the table of contents and as the subtitle in the 
assembly listing. 

Example 


l. «SUBTITLE CONDITIONAL ASSEMBLY 


This directive causes the assembler to print the following 
text as the subtitle of the assembly listing: 


CONDITIONAL ASSEMBLY 


It also causes the text to be printed out in the listing's 
table of contents, along with the source page number and the 
line sequence number of the source statement where .SUBTITLE 
was specified. The table of contents would have’ the 
following format: 


2. TABLE OF CONTENTS 


(1) 5000 ASSEMBLER DIRECTIVES 

(2) 300 MACRO DEFINITIONS 

(2) 2300 DATA TABLES AND INITIALIZATION 
(3) 4800 MAIN ROUTINE 

(4) 2800 CALCULATIONS 

(4) 5000 I/O ROUTINES 

(5) 1300 CONDITIONAL ASSEMBLY 


Note 


The alternate form of .SUBTITLE is .SBTTL. 
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TITLE 


-TITLE -- TITLE DIRECTIVE 


-TITLE assigns a name to the object module. This name is the first 31 
or fewer nonblank characters following the directive. 


Format 


-TITLE module-name comment-string 


Parameters 


module-name 


An identifier from 1 to 31 characters long. 


comment-string 


An ASCII string from 1 to 40 characters long; excess characters 
are truncated. 


Example 


Notes 


-TITLE EVAL EVALUATES EXPRESSIONS 


The module name specified with .TITLE bears no relationship 
to the file specification of the object module, as specified 
in the VAX-11 MACRO command line. Rather, the object module 
name appears in the linker load map, and is also the module 
name that the debugger and librarian recognize. 


If .TITLE is not specified, MACRO assigns the default name 
-MAIN. to the object module. If more than one .TITLE 
directive is specified in the source program, the last .TITLE 
directive encountered establishes tthe name for the entire 
object module. 


When evaluating the module-name, MACRO ignores all spaces 


and/or tabs up to the first nonspace/nontab character after 
- TITLE. 
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. TRANSFER 


- TRANSFER -- TRANSFER DIRECTIVE 


-TRANSFER redefines a global symbol for use in a shareable image. The 
linker redefines the symbol as the value of the location counter at 
the .TRANSFER directive after a shareable image is linked. 


Whenever possible, programs should not need to be relinked when the 
Shareable images to which they are linked change. This can only be 
achieved if: 


e the total size of the shareable image does not change 


e the entry points in the shareable image do not change their 
addresses when the shareable code is changed and the image is 
relinked. 


To avoid changing the size of the shareable image, reserve extra space 
when first creating the image. To insure that the entry points do not 
change, create an object module that contains a transfer vector for 
each entry point and does not change the order of the transfer 
vectors. Link this object module at the beginning of the’ shareable 
image and the addresses will remain fixed even if source code for a 
routine is changed. After each .TRANSFER directive, a register save 
mask (for procedures only) and a branch to the first instruction of 
the routine should appear. 


The .TRANSFER directive does not cause any memory to be allocated and 
does not generate any binary code. It merely generates instructions 
to the linker to redefine the symbol when a shareable image is’ being 
created. 


-TRANSFER can be used with procedures entered by the CALLS or CALLG 
instruction. In this case, .TRANSFER is used with the .ENTRY and 
-MASK directives. The branch to the actual routine must be a_ branch 
to the entry point plus 2. Adding 2 to the address is necessary to 
bypass the 2-byte régister save mask. 


Figure 5-1 illustrates the use of transfer vectors. 


Program 
Calling 
Procedure 


Transfer 
Vector 
Module 


Shareable 
Image 


Other 
Object 
Modules 
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Linked with Shareable Image 


.TRANSFER ROUTA 
MASK ROUTA 
BRW ROUTA+2 
TRANSFER 

MASK 

BRW 


»- ENTRY ROUTB,O 
;START OF ROUTINE 


RET 





Linked with Object Modules 


Program 
Calling CALLS 
Procedure 
ENTRY ROUTB,O 
Object ; START OF ROUTINE 
Modules : 


RET 





Figure 5-1 Using Transfer Vectors 
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Format 

~ TRANSFER symbol 
Parameter 
symbol 


A global symbol that is an entry point in a procedure or routine. 


Example 

» TRANSFER ROUTINE A 

- MASK ROUTINE A,“M<R4,R5> ; COPY ENTRY MASK 
; AND ADD REGISTERS 
>; 4 AND 5 

BRW ROUTINE A+2 ; BRANCH TO ROUTINE 
; (PAST ENTRY MASK) 

- ENTRY ROUTINE A,”M<R2,R3> ; ENTRY POINT, SAVE 
; REGISTERS 2 AND 3 

RET 


In this example, .MASK copies a routine's entry mask to the new entry 
address specified by .TRANSFER. If the routine is placed ina 
shareable image and then called, registers 2, 3, 4, and 5 will be 
saved. 
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.WARN 


eWARN -- WARNING DIRECTIVE 


»-WARN causes the assembler to display a warning message on the 
terminal or batch log file and in the listing file (if there is one). 


Format 

-WARN [expression] ; comment 
Parameters 
expression 


An expression whose value is displayed when .WARN is’ encountered 
during assembly. 


; comment 


A comment that is displayed when .WARN is’ encountered, The 
comment must be preceded by a semicolon. 


Example 


IF DEFINED FULL 

~-IF DEFINED DOUBLE PREC 

«WARN + THIS COMBINATION NOT TESTED 
- ENDC 

» ENDC 


If the symbols FULL and DOUBLE PREC are both defined, the following 
warning message is displayed. 


%MACRO-W-GENWRN, Generated WARNING: THIS COMBINATION NOT TESTED 
Notes 


1. .WARN, .ERROR, and .PRINT are called the message display 
directives. They can be used to display information 
indicating that a macro call contains an error or an illegal 
set of conditions (see Chapter 6 for more information on 
Macro calls). 


2. When the assembly is finished, the assembler displays’ the 
total number of errors, warnings, and information messages, 
and the page numbers and line numbers of the lines’ causing 
the errors or warning on the terminal (or in the batch log 
file). See the VAX-11 MACRO User's Guide for more 
information on errors and warnings. 


3. If .WARN is included in a macro library (see the VAX-11 MACRO 
User's Guide), the comment should end with an additional 
semicolon. Otherwise, the comment will be stripped from the 
directive and will not be displayed when the macro is called. 


4. The line containing the .WARN directive is not included in 
the listing file. 


5. If the expression has a value of 0, it is not displayed in 
the warning message. 
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.WEAK 


~WEAK -- WEAK SYMBOL ATTRIBUTE DIRECTIVE 


~WEAK specifies symbols that are either defined externally in another 
module or defined globally in the current module. .WEAK suppresses 
any object library search for the symbol. 


When .WEAK specifies a symbol that is not defined in the current 
module, the symbol is externally defined. If the linker finds the 
symbol's definition in another module, it uses that definition. If 
the linker does not find an external definition, the symbol has a 
value of 0 and the linker does not report an error. The linker does 
not search a library for the symbol, but if a module brought in from a 
library for another reason contains the symbol definition, the linker 
uses it. 


When .WEAK specifies a symbol that is defined in the current module, 
the symbol is considered to be globally defined. However, if this 
module is inserted in an object library, this symbol is not _ inserted 
in the library's symbol table. Consequently, searching the library at 
link time to resolve this symbol does not cause the module to _ be 
included. 
Format 

. WEAK symbol-list 
Parameter 
symbol-list 

A list of legal symbols separated by commas. 


Example 


- WEAK IOCAR,LAB 3 
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-WORD 


eWORD -- WORD STORAGE DIRECTIVE 


-WORD generates successive words (2 bytes) of data in the object 
module. 


Format 
~WORD expression-list 

Parameter 

expression-list 
One or more expressions separated by commas. Each expression 
optionally can be followed by a repetition factor delimited by 
square brackets. 
An expression followed by a repetition factor has the format: 

expressionl [expression2] 

expressionl 
An expression that specifies the value to be stored. 

{[expression2] 
An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 

Example 

-WORD “X3F,FIVE[3],32 


Notes 


1. The expression is first evaluated as a longword, then 
truncated to aword. The value of the expression should be 
in the range of -32768 through 32767 for signed data or 0 
through 65535 for unsigned data. The assembler displays an 
error if the high-order 2 bytes of the longword expression 
have a value other than 0 or “XFFFF. 


2. The .SIGNED WORD directive is the same as .WORD except that 
the assembler displays a diagnostic message if a value is in 
the range from 32768 to 65535. 


CHAPTER 6 


MACROS 


By using macros, a programmer can uSe a Single line to insert a 
sequence of source lines into a program. 


A macro definition contains the source lines of the macro. The macro 
definition can optionally have formal arguments. These formal 
arguments can be used throughout the sequence of source lines. Later, 
the formal arguments are replaced by the actual arguments in the macro 
call. 


The macro call consists of the macro name optionally followed by 
actual arguments. The assembler replaces the line containing the 
macro call with the source lines in the macro definition. It replaces 
any occurrences of formal arguments in the macro definition with the 
actual arguments specified in the macro call. This process is called 
the macro expansion. 


By default, macro expansions are not printed in the assembly listing. 
They are printed only when the .SHOW directive (see description in 
Chapter 5), or the /SHOW qualifier, described in the VAX-11 MACRO 
User's Guide, specifies the EXPANSIONS argument. In the examples in 
this chapter, the macro expansions are listed as they would appear if 
~-SHOW EXPANSIONS was specified in the source file or /SHOW EXPANSIONS 
was specified in the MACRO command string. 


The macro directives provide facilities for performing eight 
categories of functions. Table 6-1 lists these categories and the 
directives that fall under’ them. Section 6.1 describes macro 
arguments. Section 6.2 describes the directives in detail. For ease 
of reference, the directives are presented in alphabetical order. 
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Table 6-1 
Summary of Macro Directives 


Category Directives! 


Macro Definition -MACRO 
Directives - ENDM 


Macro Library .- LIBRARY 
Directives »MCALL 


Macro Deletion ~-MDELETE 
Directive 


Macro Exit ~MEXIT 
Directive 


Argument Attribute » NARG 
Directives ~NCHR 
eNTYPE 


Indefinite Repeat -IRP 
Block Directives ~IRPC 


Repeat Block REPEAT (.REPT) 
Directives 


End Range 
Directive 





l. The alternate form, if any, is given in parentheses. 


6.1 ARGUMENTS IN MACROS 


Macros have two types of arguments: actual and formal. Actual 
arguments are the strings given in the macro call after the name of 
the macro. Formal arguments are specified by name in the macro 
definition: that is, after the macro name in the .MACRO directive. 
Actual arguments in macro calls and formal arguments in macro 
definitions can be separated by commas, tabs, or spaces. 


The number of actual arguments in the macro call can be less than or 
equal to the number of formal arguments in the macro definition. 
But if the number of actual arguments is greater than the number of 
formal arguments, the assembler displays an error message. 


Formal and actual arguments normally maintain a strict positional 
relationship. That is, the first actual argument in a macro call 
replaces all occurrences of the first formal argument in the macro 
definition. However, this strict positional relationship can be 
overridden by the use of keyword arguments (see Section 6.1.2). 


An example of a macro definition using formal arguments follows: 


»-MACRO STORE ARG1 ,ARG2 ,ARG3 

- LONG ARG1 ; ARG1 IS FIRST ARGUMENT 
- WORD ARG3 ; ARG3 IS THIRD ARGUMENT 
-BYTE ARG2 ; ARG2 IS SECOND ARGUMENT 
- ENDM STORE 
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The following two examples show possible calls and expansions of the 
macro defined above. 


1. STORE 3,2,l ; MACRO CALL 
- LONG 3 ; 3 IS FIRST ARGUMENT 
- WORD EE ; 1 IS THIRD ARGUMENT 
~BYTE 2 ; 2 IS SECOND ARGUMENT 
26 STORE X,X-Y,2Z ; MACRO CALL 
- LONG X ; X IS FIRST ARGUMENT 
- WORD Z ; Z IS THIRD ARGUMENT 
-BYTE X-Y ; 


X-Y IS SECOND ARGUMENT 


6.1.1 Default Values 


Default values are values that are defined in the macro definition. 
They are used when no value is specified in the macro call for a 
formal argument. 


Default values are specified in the .MACRO directive as follows: 
formal-argument-name = default-value 
An example of a macro definition specifying default values follows: 
eMACRO STORE ARG1=12 ,ARG2=0 ,ARG3=1000 
- LONG ARG1L 
«WORD ARG3 
BYTE ARG2 
-ENDM STORE 


The following three examples show possible calls and expansions of the 
macro defined above. 


1. STORE ; NO ARGUMENTS SUPPLIED 
- LONG 12 
- WORD 1000 
-BYTE 0 
2. STORE 19k ; LAST TWO ARGUMENTS SUPPLIED 
- LONG 12 
» WORD X 
-BYTE 5 
3. STORE 1 ; FIRST ARGUMENT SUPPLIED 
- LONG Hi 
- WORD 1000 
-BYTE 0 


6.1.2 Keyword Arguments 


Keyword arguments allow a macro call to specify the arguments in any 
order; however, the macro call must specify the same formal argument 
names that appear in the macro definition. Keyword arguments are 
useful when a macro definition has many formal arguments, only some of 
which need to be specified in the call. 


In any one macro call the arguments should be either all positional 
arguments or all keyword arguments. When positional and keyword 
arguments are combined in a macro, only the positional arguments 
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correspond by position to the formal arguments; the keyword arguments 
are not used. If a formal argument corresponds to both a _ positional 
argument and a keyword argument, the argument that appears last in the 
macro call overrides any other argument definition for the same 
argument. 


For example, the following macro definition specifies three arguments: 


~MACRO STORE ARG1 ,ARG2 ,ARG3 
- LONG ARG1 

- WORD ARG3 

- BYTE ARG 2 

- ENDM STORE 


The following macro call specifies keyword arguments: 


STORE ARG 3=27+5/4,ARG2=5 ,ARG1=SYMBL 
- LONG SYMBL 

-WORD 27+5/4 

-BYTE 5 


Because the keywords are specified in the macro call, the arguments in 
the macro call need not be given in the order they were listed in the 
macro definition. 


6.1.3 String Arguments 


If an actual argument is a string containing characters that’ the 
assembler interprets aS separators (such as a tab, space, or comma), 
the string must be enclosed by delimiters. String delimiters are 
usually paired angle brackets (<>). However, the assembler also 
interprets any character after an initial circumflex (*) as a 
delimiter. Thus, to pass an angle bracket as part of a string, the 
programmer can use the circumflex form of the delimiter. 


The following are examples of delimited macro arguments: 


<HAVE THE SUPPLIES RUN OUT?> 

<LAST NAME, FIRST NAME> 

<LAB: CLRL R4> 

“SARGUMENT IS <LAST,FIRST> FOR CALL% 
“? EXPRESSION IS <5+3>*<4+2>? 


In the last two examples the initial circumflex indicates that the 
percent sign (%) and question mark (?), respectively, are _ the 
delimiters. Note that only the left hand delimiter is preceded by a 
circumflex. 


The assembler interprets a string argument enclosed by delimiters as 
one actual argument and associates it with one formal argument. If a 
string argument that contains separator characters is not enclosed by 
delimiters, the assembler interprets it as successive actual arguments 
and associates it with successive formal arguments. 


For example, the following macro call has one formal argument. 


-MACRO REPEAT STRNG 
-ASCII /STRNG/ 
eASCII /STRNG/ 

- ENDM REPEAT 
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The following two macro calls demonstrate actual arguments with and 
without delimiters. 


1. REPEAT <A BC D E> 
-ASCII /A BCD E/ 
»ASCII /A BCD E/ 


2. REPEAT ABCD E 
%$MACRO-E-TOOMNYARGS, Too many arguments in MACRO call 


Note that the assembler interpreted the second macro call as_ having 
five actual arguments instead of one actual argument with spaces. 


When a macro is called, the assembler removes the delimiters (if 
present) around a string before associating it with the formal 
arguments. 


If a string contains a semicolon, the string must be enclosed by 
delimiters, or the semicolon will mark the start of the comment field. 


To pass a number containing a radix or unary operator (for example, 
“XF19), the entire argument must be enclosed by delimiters, or the 
assembler will interpret the radix operator as a delimiter. The 
following are macro arguments that are enclosed in delimiters because 
they contain radix operators: 


<“XF19> 
<*B01100011> 
<*F1.5> 


Macros can be nested, that is a macro definition can contain a call to 
another macro. If within a macro definition, another macro is called 
and passed a string argument, the programmer must delimit the argument 
so that the entire string is passed to the second macro as one 
argument. 


The following macro definition contains a call to the REPEAT macro 
defined in an earlier example: 


»MACRO CNTRPT LAB1,LAB2,STR_ARG 
LAB1: ~BYTE LAB2-LAB1-1 ; LENGTH OF 2+STRING 


REPEAT <STR_ARG> ; CALL REPEAT MACRO 
LAB2: 


- ENDM CNTRPT 


Note that the argument in the call to REPEAT is enclosed in angle 
- brackets even though the actual argument does not contain any 
separator characters. This is done because the actual argument in the 
call to REPEAT is a formal argument in the macro definition and will 
be replaced with an actual argument that may contain separator 
characters. 


The following example calls the macro CNTRPT which in turn calls’ the 
macro REPEAT: 


CNTRPT ST,FIN,<LEARN YOUR ABC'S> 

ST? eBYTE FIN-ST-1 ; LENGTH OF 2*STRING 
REPEAT <LEARN YOUR ABC'S> ; CALL REPEAT MACRO 
eASCII /LEARN YOUR ABC'S/ 
eASCII /LEARN YOUR ABC'S/ 

FIN: 
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An alternative method to pass string arguments in nested macros is_ to 
enclose the macro argument in nested delimiters. In this case the 
macro calls in the macro definitions should not have delimiters. Each 
time the delimited argument is used in a macro call, the assembler 
removes the outermost pair of delimiters before associating it with 
the formal argument. This method is not recommended because it 
requires that the programmer know how deeply a macro is nested. 


The following macro definition also contains a call to the repeat 
macro: 


-MACRO CNTRPT2 LAB1,LAB2,STR_ARG 
LAB1: -BYTE LAB2~-LAB1-1 ; LENGTH OF 2*STRING 


REPEAT STR_ARG ; CALL REPEAT MACRO 


LAB2: 
- ENDM CNTRPT2 


Note that the argument in the call to REPEAT is not enclosed in angle 
brackets. 


The following example calls the macro CNTRPT2: 


CNTRPT2 BEG,TERM,<<MIND YOUR P'S AND Q'S>> 

BEG : -BYTE TERM-BEG-1 ; LENGTH OF 2*STRING 
REPEAT <MIND YOUR P'S AND Q'S> ; CALL REPEAT MACRO 
»ASCII /MIND YOUR P'S AND Q'S/ 
eASCII /MIND YOUR P'S AND Q'S/ 

TERM: 


Note that even though the call to REPEAT in the macro definition is 
not enclosed in delimiters, the call in the expansion is enclosed in 
delimiters because the call to CNTRPT2 contains nested delimiters 
around the string argument. 


6.1.4 Argument Concatenation 


The argument concatenation operator, the apostrophe ('), concatenates 
a macro argument with some constant text. Apostrophes can either 
precede or follow a formal argument name in the macro source. 


If an apostrophe precedes the argument name, the text before’ the 
apostrophe is concatenated with the actual argument when the macro is 
expanded. For example, if ARGl is a formal argument associated with 
the actual argument TEST, ABCDE'ARG1 is expanded to ABCDETEST. 


If an apostrophe follows the formal argument name, the actual argument 
is concatenated with the text that follows the apostrophe when the 
macro is expanded. For example, if ARG2 is a formal argument 
associated with the actual argument MOV, ARG2'L is expanded to MOVL. 


Note that the apostrophe itself does not appear in the macro 
expansion. 


To concatenate two arguments, separate the two formal arguments’ with 
two successive apostrophes. Two apostrophes are needed because each 
concatenation operation discards an apostrophe from the expansion. 
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An example of a macro definition that uses concatenation follows: 


~MACRO CONCAT INST,SIZE,NUM 
TEST'NUM': INST''SIZE RO,R'NUM 
TEST'NUM'X: 

- ENDM CONCAT 


Note that two successive apostrophes are used when concatenating the 
two formal arguments INST and SIZE. 


An example of a macro call and expansion follows: 


CONCAT MOV,L,5 
TEST5: MOVL RO,R5 
TEST5X: 


6.1.5 Passing Numeric Values of Symbols 


When a symbol is specified as an actual argument, the name of the 
symbol, not the numeric value of the symbol, is passed to the macro. 
However, the value of the symbol can be passed by inserting a 
backslash before the symbol in the macro call. The assembler then 
passes the characters representing the decimal value of the symbol to 
the macro. For example, if the symbol COUNT has a value of 2 and the 
actual argument specified is \COUNT, the assembler passes the string 
"2" to the macro; it does not pass the name of the symbol, "COUNT". 


Passing numeric values of symbols is especially useful with _ the 
apostrophe (') concatenation operator for creating new symbols. 


An example of a macro definition for passing numeric values of symbols 
follows: 


-MACRO TESTDEF,TESTNO, ENTRYMASK="?°M<>? 
eENTRY TEST'TESTNO,ENTRYMASK ; USES ARG CONCATENATION 
-ENDM TESTDEF 


The following example shows a possible call and expansion of the macro 
defined above: 


COUNT = 2 
TESTDEF \COUNT 
~ENTRY TEST2,°M<> 
COUNT = COUNT + 1 
TESTDEF \COUNT,~?“M<R3,R4>? 
-ENTRY TEST3,°M<R3,R4> 


6.1.6 Created Local Labels 


Local labels are often very useful in macros. Although the programmer 
can specify local labels in the macro definition, these local labels 
might be duplicated elsewhere in the local label block and might’ thus 
cause errors. However, the programmer can use the assembler to create 
local labels in the macro expansion which will not conflict with other 
local labels. These labels are called created local labels. 


Created local labels range from 30000$ through 65535$. Each time the 
assembler creates a new local label, it increments the numeric part of 
the label name by 1. Consequently, no user-defined local labels 
should be in the range of 30000$ through 65535S. 


The programmer specifies a created local label by a question mark 
front of 


placed in 
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(?) 


the formal argument name. When the macro is 


expanded, the assembler creates a new local label if the corresponding 


actual argument is’ blank. If the corresponding actual argument is 
specified, the assembler substitutes the actual argument for’ the 
formal argument. Created local symbols can be used only in the first 


31 formal arguments specified in the 


Created local labels can be associated 
created 


arguments; 


«MACRO directive. 


only with positional actual 


local labels cannot be associated with keyword 


actual arguments. 


The following example is a macro definition specifying a created local 


label: 
eMACRO POSITIVE ARG1,?L1 
TSTL ARG1 
BGEQ Cl 
MNEGL ARG1,ARG1 
Ll: ~ENDM POSITIVE 
The following three calls and expansions of the macro defined above 
show both created local labels and a user-specified local label: 
1. POSITIVE RO 
TSTL RO 
BGEQ 30000$ 
MNEGL RO ,RO 
300008: 
2. POSITIVE COUNT 
TSTL COUNT 
BGEQ 30001$ 
MNEGL COUNT , COUNT 
30001S$: 
3% POSITIVE VALUE,10$ 
TSTL VALUE 
BGEQ 10$ 
MNEGL VALUE, VALUE 
10S: 
6.1.7 Macro String Operators 
The three macro string operators are: 
e %LENGTH 
e %LOCATE 
@ EXTRACT 
These operators perform string manipulations on matro arguments and 


ASCII strings. They can be used only in macros and repeat blocks. 
The following sections describe these operators and give their formats 
and examples of their use. 
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%LENGTH 


6.1.7.1 %LENGTH Operator - The %LENGTH operator returns the length of 
a String. For example, the value of *LENGTH(<ABCDE>) is 5. 


Format 
%LENGTH (string) 

Parameters 

string 
A macro argument or a delimited string. The string can be 
delimited by angle brackets or a character preceded by a 
circumflex (see Section 6.1.3). 

Examples 


Macro definition: 


eMACRO CHK SIZE ARG1 
IF GREATER EQUAL % LENGTH (ARG1) -3 


MACRO CHECKS IF ARG1 
IS BETWEEN 3 AND 


=e Me we 


IF LESS_THAN 6-%LENGTH (ARG1) 6 CHARACTERS LONG 
» ERROR ; ARGUMENT ARG1 IS GREATER THAN 6 CHARACTERS 
- ENDC ; IF MORE THAN 6 

-IF FALSE ; IF LESS THAN 3 

. ERROR ; ARGUMENT ARG] IS LESS THAN 3 CHARACTERS 

- ENDC ; OTHERWISE DO 

- ENDM CHK SIZE ; NOTHING 


Macro calls and expansions of the macro defined above: 


1. CHK SIZE A ; SHOULD BE TOO SHORT 
-IF GREATER EQUAL 1-3 ; IS BETWEEN 3 AND 
-IF LESS THAN 6-1 ; 6 CHARACTERS LONG 
-ERROR ~— ; ARGUMENT A IS GREATER THAN 6 CHARACTERS 
~ ENDC ; IF MORE THAN 6 
IF FALSE ; IF LESS THAN 3 
%$MACRO-E-GENERR, Generated ERROR: ARGUMENT A IS LESS THAN 3 CHARACTERS 
»ENDC ; OTHERWISE DO 
2. CHK SIZE ABC ; SHOULD BE OK 
» IF GREATER EQUAL 3-3 ; IS BETWEEN 3 AND 
-IF LESS THAN 6-3 ; 6 CHARACTERS LONG 
» ERROR ; ARGUMENT ABC IS GREATER THAN 6 CHARACTERS 
- ENDC ; IF MORE THAN 6 
-IF_FALSE ; IF LESS THAN 3 
- ERROR ; ARGUMENT ABC IS LESS THAN 3 CHARACTERS 
- ENDC ; OTHERWISE DO 
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%LOCATE 


6.1.7.2 %LOCATE Operator - The $LOCATE operator locates a _ substring 
within a_ string. If LOCATE finds a match of the substring, it 
returns the character position of the first character of the match in 
the string. For example, the value of %LOCATE(<D>,<ABCDEF>) is 3. 
Note that the first character position of a string is 0. If %LOCATE 
does not find a match, it returns a value equal to the length of the 
String. For example, the value of %LOCATE(<Z>,<ABCDEF>) is 6. 


The $LOCATE operator returns a numeric value that can be used in any 
expression. 


Format 

%LOCATE(Stringl,string2 [,sSymbol] ) 
Parameters 
stringl 


A string that specifies the substring. The substring can be 
either a macro argument or a delimited string. The delimiters 
can be either angle brackets or a character preceded by a 
circumflex. 


string2 


The string that is searched for the substring. The string can be 
either a macro argument or a delimited string. The delimiters 
can be either angle brackets or a character preceded by a 
circumflex. 


symbol 


An optional symbol or decimal number that specifies the position 
in string2 at which the assembler should start the search. If 
this argument is omitted, the assembler starts the search at 
position 0 (the beginning of the string). A symbol must be an 
absolute symbol that has been previously defined and a number 
must be an unSigned decimal number. Expressions and radix 
operators are not allowed. 


Example 


Macro definition: 


-MACRO BIT NAME ARG1 ; CHECKS IF ARG1 IS IN LIST 
-IF EQUAL %$LOCATE (ARG1 ,<DELDFWDLTDMOESC>) -15 

; IF IT IS NOT PRINT ERROR 
- ERROR ; ARG1 IS AN INVALID BIT NAME 
- ENDC ; IF IT IS DO 
. ENDM BIT NAME ; NOTHING 
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Macro calls and expansions of the macro defined above: 


l. BIT NAME ESC ; IS IN LIST 
.IF EQUAL 12-15 
; IF IT IS NOT PRINT ERROR 
. ERROR : ESC IS AN INVALID BIT NAME 
. ENDC > IF IT IS DO 
2. BIT NAME FOO : NOT IN LIST 
.IF EQUAL 15-15 


; IF IT IS NOT PRINT ERROR 
%$MACRO-E-GENERR, Generated ERROR: FOO IS AN INVALID BIT NAME 


- ENDC : IF IT IS DO 
Note 


If the optional symbol is specified, the search begins at the 
character position of string2 specified by the symbol. For 
example, the value of %LOCATE(<ACE>,<SPACE HOLDER>,5) is 12 
because there is no match after the Sth character position. 


%EXTRACT 


6.1.7.3 %EXTRACT Operator - The %EXTRACT operator extracts a 
substring from a string. It returns the substring that begins at the 
specified position and is the specified length. For example, the 
value of $EXTRACT(2,3,<ABCDEF>) is CDE. Note that the first character 
in a string is in position 0. 


Format 

%EXTRACT (Symboll,symbol2,string) 
Parameters 
symboll 


A symbol or decimal number that specifies the starting position 
of the substring. A symbol must be an absolute symbol that has 
been previously defined and a number must be an unsigned decimal 
number. Expressions and radix operators are not allowed. 


symbol 2 


A symbol or decimal number that specifies the length of the 
substring. A symbol must be an absolute symbol that has been 
previously defined and a number must be an unsigned decimal 
number. Expressions and radix operators are not allowed. 


String 
A macro argument or a delimited string. The string can be 


delimited by angle brackets or a character preceded by a 
circumflex. 


MACROS 


Example 
Macro definition: 


-MACRO RESERVE ARG1 
XX = $LOCATE (<=>,ARG1) 
-IF EQUAL XX-%LENGTH (ARG1) 
- WARN ; INCORRECT FORMAT FOR MACRO CALL —- ARG1 
»MEXIT 
- ENDC 


SEXTRACT (0,XX,ARG1):: 

XX = XX+] 
-BLKB %& EXTRACT (XX,3,ARG1) 
- ENDM RESERVE 


Macro calls and expansions of the macro defined above: 


l. RESERVE FOOBAR 
XX = 6 
-IF EQUAL XX-6 
%MACRO-W-GENWRN, Generated WARNING: INCORRECT FORMAT FOR MACRO CALL - FOOBA 


~MEXIT 
2e RESERVE LOCATION=12 
XX = 8 
e-IF EQUAL xXxX-11l 
» WARN 3; INCORRECT FORMAT FOR MACRO CALL - LOCATION=12 
»MEXIT 
«ENDC 
LOCATION: : 
XX = XX+1 
«BLKB 12 
Notes 


If the starting position specified is greater than or equal _ to 
the length of the string, %EXTRACT returns a null string (a 
string of 0 characters). If the length specified is 0, %EXTRACT 
returns a null string. 


6.2 MACRO DIRECTIVES 
The remainder of this chapter describes the macro directives in 


detail, showing their formats and giving examples of their use. The 
directives are presented in alphabetical order. 


-ENDM 


«ENDM--END DEFINITION DIRECTIVE 


»ENDM terminates the macro definition. See the description of .MACRO 
for an example of the use of .ENDM. 


Format 
~-ENDM [macro-name] 

Parameter 

macro-name 
The name of the macro whose definition is to be terminated. The 
macro name is’ optional; but, if specified, it must match the 
name defined in the matching .MACRO directive. The macro name 
should be specified so that the assembler can detect = any 
improperly nested macro definitions. 


Note 


If .ENDM is encountered outside a macro definition, the assembler 
displays an error message. 


-ENDR 


eENDR--END RANGE DIRECTIVE 

- ENDR indicates the end of a repeat’ range, It must be the final 
Statement of every indefinite repeat block directive (.IRP and .IRPC) 
and every repeat block directive (.REPEAT). See the description of 
these directives for examples of the use of .ENDR. 

Format 


- ENDR 


MACROS 
.IRP 


eIRP--INDEFINITE REPEAT ARGUMENT DIRECTIVE 


-IRP replaces a formal argument with successive actual arguments 
specified in an argument list. This replacement process occurs during 
the expansion of the indefinite repeat block range. The .ENDR 
directive specifies the end of the range. 


-IRP iS analogous to a macro definition with only one formal argument. 
At each expansion of the repeat block, this formal argument is 
replaced with successive elements from the argument list. The 
directive and its range are coded inline within the source program. 
This type of macro definition and its range do not require calling the 
macro by name, as do other macros described in this chapter. 


-IRP can appear either within or outside another macro definition, 
indefinite repeat block, or repeat block (see the description of 
e-REPEAT). The rules for specifying .IRP arguments are the same as 
those for specifying macro arguments. 


Format 


-IRP symbol,<argument list> 


-ENDR 
Parameters 
symbol 


A formal argument that is successively replaced with the 
specified actual arguments enclosed in angle brackets. If no 
formal argument is specified, the assembler displays an error 
message. 


<argument list> 


A list of actual arguments enclosed in angle brackets and used in 
expanding the indefinite repeat range. An actual argument can 
consist of one or more characters; multiple arguments must_ be 
separated by a legal separator (comma, space, or tab). If no 
actual arguments are specified, no action is taken. 


range 
The block of source text to be repeated once for each occurrence 


of an actual argument in the list. The range can contain macro 
definitions and repeat ranges. .MEXIT is legal within the range. 


MACROS 


Example 


Macro definition: 


~MACRO CALL _SUB SUBR,A1,A2,A3,A4,A5,A6,A7,A8 ,A9 ,A10 
.NARG COUNT 

.IRP ARG ,<Al10,A9,A8,A7,A6,A5,A4,A3,A2,Al> 

-IIF NOT BLANK ARG, PUSHL ARG 

-ENDR 

CALLS #<COUNT-1>,SUBR > NOTE SUBR IS COUNTED 


-ENDM CALL_SUB 


Macro call and expansion of the macro defined above: 


CALL_SUB TEST, INRES, INTES, UNLIS, OUTCON, #205 
-NARG COUNT 

. IRP ARG ,<,7777#205,OUTCON,UNLIS, INTES, INRES> 
-IIF NOT BLANK ARG, PUSHL ARG 

-ENDR ~ 

-IIF NOT BLANK , PUSHL 

-IIF NOT BLANK , PUSHL 

~IIF NOT BLANK , PUSHL 

-IIF NOT BLANK , PUSHL 


-IIF NOT BLANK , PUSHL 

~IIF NOT BLANK #205, PUSHL #205 

~IIF NOT BLANK OUTCON, PUSHL  OUTCON 

-IIF NOT BLANK UNLIS, PUSHL UNLIS 

-IIF NOT BLANK INTES, PUSHL INTES 

-IIF NOT BLANK INRES, PUSHL INRES 

CALLS #<COUNT-1>,TEST ; NOTE TEST IS COUNTED 


This example uses the .NARG directive to count the arguments and_ the 
-IIF NOT _BLANK directive (see descriptions of .IF and .IIF in Chapter 
5). to determine whether the actual argument is’ blank. If the 
argument is blank, no binary code is generated. 


MACROS 


.IRPC 


-IRPC--INDEFINITE REPEAT CHARACTER DIRECTIVE 


-IRPC is similar to .IRP except that .IRPC permits single-character 
substitution, rather than argument substitution. On each iteration of 
the indefinite repeat range, the formal argument is replaced with each 
successive character in the specified string. The .ENDR directive 
specifies the end of the range. 


-IRPC is analogous to a macro definition with only one formal 
argument. At each expansion of the repeat block, this formal argument 
is replaced with successive characters from the actual argument 
string. The directive and its range are coded inline within the 
Source program and do not require calling the macro by name, as_ do 
other macros described in this chapter. 


-IRPC can appear either within or outside another macro definition, 
indefinite repeat block, or repeat block (see description of .REPEAT). 


Format 


-IRPC symbol,<string> 


«ENDR 

Parameters 

symbol 
A formal argument that is successively replaced with the 
specified characters enclosed in angle brackets. If no formal 
argument is specified, the assembler displays an error message. 
\ 

<string> 
A sequence of characters enclosed in angle brackets and used _ in 
the expansion of the indefinite repeat range. Although the angle 
brackets are required only when the string contains’ separating 
characters, their use is recommended for legibility. 

range 
The block of source text to be repeated once for each occurrence 


of a character in the. list. The range can contain macro 
definitions and repeat ranges. .MEXIT is legal within the range. 


MACROS 


Example 
Macro Definition: 


~MACRO HASH_SYM SYMBOL 
-NCHR HV,<SYMBOL> 
~IRPC CHR,<SYMBOL> 
HV = HV+°A?CHR? 
.ENDR 
~ENDM HASH_SYM 


Macro call and expansion of the macro defined above: 
HASH SYM <MOVC5> 


»NCHR HV, <MOVC5> 
~IRPC CHR, <MOVC5> 


HV = HV+°A?CHR? 
-ENDR 
HV = HV+°A?M? 
HV = HV+"A?0? 
HV = HV+“A?V? 
HV = HV+°A?C? 
HV = HV+°A?5? 


This example uses the .NCHR directive to count’ the 
characters in actual argument. 


number 


of 


MACROS 


-LIBRARY 


- LIBRARY-~MACRO LIBRARY DIRECTIVE 


-LIBRARY adds a name to the macro library list that is searched 
whenever a .MCALL or an undefined opcode iS encountered. The 
libraries are searched in the reverse order in which they were 
specified to the assembler. 


If the programmer omits any information from the macro-library-~-name 
argument, default values are assumed. The device defaults to the 


user's disk; the directory defaults to the user's directory; and the 
file type defaults to MLB. 


DIGITAL recommends that libraries be specified in the MACRO command 


line with the /LIBRARY qualifier rather than with the .LIBRARY 
directive. The .LIBRARY directive makes moving files cumbersome. 


Format 

~LIBRARY macro-library-name 
Parameter 
macro-library-name 


A delimited string that is the file specification of a macro 
library. 


Example 


-LIBRARY /DB1: [TEST] USERM/ ; MACRO LIBRARY USERM.MLB 
-LIBRARY ?DB1:SYSDEF.MLB? 
~LIBRARY \CURRENT.MLB\ 


MACROS 


.MACRO 


eMACRO--MACRO DEFINITION DIRECTIVE 

-MACRO begins the definition of a macro. It gives the macro name and 
a list of formal arguments (see Section 6.1). If the name specified 
is the same as the name of a previously defined macro, the previous 
definition is deleted and replaced with the new one. The .MACRO 
directive is followed by the source text to be included in the macro 
expansion. The .ENDM directive specifies the end of the range. 


Macro names do not conflict with user-defined symbols. A macro and a 
user-defined symbol can both have the same name. 


When the assembler encounters a .MACRO directive, it adds the macro 
name to its macro name table and stores the source text of the macro 
(up to the matching .ENDM directive). No other processing occurs 
until the macro is expanded. 

The symbols in the formal argument list are associated with the macro 
name and are limited to the scope of the definition of that macro. 
For this reason, the symbols that appear in the formal argument list 
can also appear elsewhere in the program. 

Format 


»-MACRO macro-name [formal-argument-list] 


~-ENDM [macro name] 
Parameters 
mMacro-name 


The name of the macro to be defined; this name can be any legal 
symbol up to 31 characters long. 


formal-argument-list 


The symbols, separated by commas, to be replaced by the actual 
arguments in the macro call. 


range 


The source text to be included in the macro expansion. 


MACROS 


Example 
Macro definition: 


e-MACRO USERDEF 
«-PSECT DEFS,ABS 


MYSYM= 5 
HIVAL= “XFFF123 
LOWVAL= 0 


.PSECT RWDATA,NOEXE,LONG 
TABLE: .BLKL 100 
LIST: -BLKB 10 
-MACRO USERDEF ; REDEFINE IT TO NULL 
-ENDM USERDEF 
.ENDM  USERDEF 


Macro calls and expansions of the macro defined above: 


is USERDF ; SHOULD EXPAND DATA 
-PSECT DEFS,ABS 

MYSYM= 5 

HIVAL= “XFFF123 

LOWVAL= 0 


-PSECT RWDATA,NOEXE,LONG 

TABLE: .BLKL 100 

LIST: -BLKB 10 
-MACRO USERDEF ; REDEFINE IT TO NULL 
-ENDM USERDEF 


2% USERDF ; SHOULD EXPAND NOTHING 


In this example, when the macro is called the first time it defines 
some symbols and data storage areas and then redefines itself. When 
the macro is called a second time, the macro expansion contains no 
source text. 


Notes 


1. If a macro has the same name as a VAX-11 opcode, the macro is 
used instead of the instruction. This feature allows a 
programmer to temporarily redefine an opcode. 


2. If a macro has the same name as a VAX-11 opcode and is in a 
macro library, the .MCALL directive must be used to define 
the macro. Otherwise, because the symbol is already defined 
(as the opcode), the assembler will not search the macro 
libraries. 


3. The programmer can redefine a macro with new source text 
during assembly by specifying a second .MACRO directive with 
the same name. Including a second .MACRO directive within 
the original macro definition causes the first macro call to 
redefine the macro. This is useful when a macro- performs 
initialization or defines symbols; that is, when an 
operation is performed only once. The macro redefinition can 
eliminate unneeded source text in a macro or it can delete 
the entire macro. The .MDELETE directive provides) another 
way to delete macros. 


MACROS 


-MCALL 


»~MCALL~-MACRO CALL DIRECTIVE 
-MCALL specifies the names of the system and/or user-defined macros 
that are required to assemble the source program but are not defined 
in the source file. 
If any named macro is not.found upon completion of the search (that 
is, if the macro is not defined in any of the macro libraries), the 
assembler displays an error message. 
Format 

~-MCALL macro-name-list 
Parameter 


macro-name-list 


A list of macros to be defined for this assembly. The names must 
be separated by commas. 


Example 


~-MCALL INSQUE SUBSTITUTE MACRO IN 
LIBRARY FOR INSQUE 


INSTRUCTION 


=e te Me 


Note 


-MCALL is provided for compatibility with MACRO-11; DIGITAL 
recommends that it not be used. When VAX-11 MACRO finds an 
unknown symbol in the opcode field, it automatically searches all 
macro libraries. If it finds the symbol ina library, it uses 
the macro definition and expands the macro reference. If VAX-11 
MACRO does not find the unknown symbol in the library, it 
displays an error message. There iS one exception for which 
-MCALL must be used: when a macro has the same name as an opcode 
(see description of .MACRO). 


MACROS 


-MDELETE 


»MDELETE-~MACRO DELETION DIRECTIVE 


-MDELETE deletes the definitions of specified macros. The number of 
macros actually deleted is printed in the assembly listing on the same 
line as the .MDELETE directive. 


-MDELETE completely deletes the macro, freeing memory as _ necessary, 


whereas the technique of macro redefinition explained in the 
description of .MACRO merely redefines the macro. 


Format 

-MDELETE macro-name-list 
Parameter 
macro-name-list 


A list of macros whose definitions are to be deleted. The names 
must be separated by commas. 


Example 


-MDELETE USERDEF,SSSDEF,ALTR 


MACROS 
.MEXIT 


eMEXIT--MACRO EXIT DIRECTIVE 


-MEXIT terminates a macro expansion before the end of the macro. 
Termination is the same as if .ENDM was encountered. The directive 
can also be used within repeat blocks. »-MEXIT is most useful in 
conditional expansion of macros because it bypasses the complexities 
of nested conditional directives and alternate assembly paths. 


Format 
-MEXIT 
Example 
-MACRO POLO N,A,B 
~IF EQ N ; START CONDITIONAL ASSEMBLY BLOCK. 
»MEXIT ; TERMINATE MACRO EXPANSION. 
eENDC ; END CONDITIONAL ASSEMBLY BLOCK. 
- ENDM POLO ; NORMAL END OF MACRO. 


In this example, if the actual argument for the formal argument N 
equals 0, the conditional block would be assembled, and the macro 
expansion would be terminated by .MEXIT. 


Notes 


1. When .MEXIT occurs in a repeat block, _ the assembler 
terminates the current repetition of the range and suppresses 
further expansion of the repeat range. 


2. When macros or repeat blocks are nested, .MEXIT exits to’ the 
next higher level of expansion. 


3. If .MEXIT occurs outside a macro definition or. a repeat 
block, the assembler displays an error message. 


MACROS 
.NARG 


«NARG--NUMBER OF ARGUMENTS DIRECTIVE 
-NARG determines the number of arguments in the current macro call. 
-NARG counts all the positional arguments specified in the macro call, 
including null arguments (specified by adjacent commas). The value 
assigned to the specified symbol does not include either any keyword 
arguments or any formal arguments that have default values. 
Format 

»NARG symbol 
Parameter 


symbol 


A symbol that is assigned a value equal to the number of 
arguments in the macro call. 


Example 
Macro definitions: 


~MACRO CNT_ARG Al,A2,A3,A4,A5,A6,A7,A8 ,A9=DEF9 ,A10=DEF10 

.NARG COUNTER ; COUNTER IS SET TO NO. OF ARGS 
.WORD COUNTER ; STORE VALUE OF COUNTER 

.ENDM CNT_ARG 


Macro calls and expansions of the macro defined above: 
‘Ls CNT ARG TEST,FIND,ANS 


»NARG COUNTER 
-WORD COUNTER 


COUNTER WILL = 3 
COUNTER IS SET TO NO. OF ARGS 
STORE VALUE OF COUNTER 


mo "ee Ne 


2. CNT_ARG 
.NARG COUNTER 
.WORD COUNTER 


COUNTER WILL = 0 
COUNTER IS SET TO NO. OF ARGS 
STORE VALUE OF COUNTER 


moe “es MO 


COUNTER WILL = 1 

COUNTER IS SET TO NO. OF ARGS 
STORE VALUE OF COUNTER 

KEYWORD ARGUMENTS ARE NOT COUNTE 


3. CNT_ARG TEST ,A2=SYMB2,A3=SY3 
»NARG COUNTER 
- WORD COUNTER 


me Se we TO 


4. CNT_ARG ,SYMBL,, 
-NARG COUNTER 
- WORD COUNTER 


COUNTER WILL = 3 

COUNTER IS SET TO NO. OF ARGS 
STORE VALUE OF COUNTER 

NULL ARGUMENTS ARE COUNTED 


me te SNe NO 


Note 


If .NARG appears outside of a macro, the assembler displays an 
message. 


MACROS 


-NCHR 


~-NCHR--NUMBER OF CHARACTERS DIRECTIVE 
e-NCHR determines the number of characters in a specified character 
string. It can appear anywhere in a VAX-11 MACRO program and is 
useful in calculating the length of macro arguments. 
Format 

»NCHR symbol,<string> 
Parameters 


symbol 


A symbol that is assigned a value equal to the number of 
characters in the specified character string. 


<string> 


A sequence of printable characters. The character string must be 
delimited by angle brackets or a character preceded by a 
circumflex only if the specified character string contains a 
legal separator (comma, space, and/or tab) or a semicolon, 


Example 
Macro definition: 


»MACRO CHAR MESS 
~NCHR CHRCNT, <MESS> 
.-WORD CHRCNT 

-ASCII /MESS/ 

. ENDM CHAR 


DEFINE MACRO 

ASSIGN VALUE TO CHRCNT 
STORE VALUE 

STORE CHARACTERS 
FINISH 


=e “"e Se we WO 


Macro calls and expansions of the macro defined above: 


l. CHAR <HELLO> 
-NCHR CHRCNT, <HELLO> 
- WORD CHRCNT 
-ASCII /HELLO/ 


CHRCNT WILL = 5 

ASSIGN VALUE TO CHRCNT 
STORE VALUE 

STORE CHARACTERS 


=e “se “@ we 


Ze CHAR <14, 75.39 4> 
.NCHR CHRCNT,<14, 75.39 4> 
.WORD CHRCNT 
eASCII /14, 75.39 4/ 


CHRCNT WILL = 12 (DEC) 
ASSIGN VALUE TO CHRCNT 
STORE VALUE 

STORE CHARACTERS 


=e te TO we 


MACROS 


.NTYPE 


eNTYPE--OPERAND TYPE DIRECTIVE 
-NTYPE determines the addressing mode of the specified operand. 


The value of the symbol is set to the specified addressing mode. In 
most cases, an 8-bit (l-byte) value is returned. Bits 0 through 3 
specify the register associated with the mode, and bits 4 through 7 
specify the addressing mode. To provide concise addressing 
information, the mode bits 4 through 7 are not exactly the same as the 
numeric value of the addressing mode described in Table 4-1. 
Specifically, literal mode is indicated by a 0 in bits 4 through 7 
instead of the values 0 through 3 described in Table 4-1. Mode 1 
indicates an immediate mode operand, mode 2 indicates an absolute mode 
operand, and mode 3 indicates a general mode operand. 


For indexed addressing mode, a 16-bit (2-byte) value is returned. The 
high-order byte contains the addressing mode of the base operand 


specifier and the low-order byte contains the addressing mode of the 
primary operand (the index register). 


See the VAX-11 Architecture Handbook and Chapter 4 of this manual for 
more information on addressing modes. 
Format 
»NTYPE symbol ,operand 
Parameter 
symbol 
Any legal VAX-11 MACRO symbol. This symbol is assigned a_ value 
equal to the 8- or 16-bit addressing mode of the operand argument 
that follows. 


operand 


Any legal address expression, as used with an _ opcode. If no 
argument is specified, 0 is assumed. 


Example 


MACROS 


Macro Definition: 


ADDRESS AND, 
AND GENERATES 


me ™e@ te Me Me TO 


.»MACRO 
-NTYPE 
A = A@-4&*XF 


-IF IDENTICAL 0,<ADDR> 


PUSHL 

eMEXIT 

» ENDC 
ERR = 0 


-IIF LESS EQUAL A-1, ERR=1 
eIIF EQUAL A-5, ERR=1 
-IF EQUAL ERR 


PUSHAL 
oT FF 
PUSHL 
- WARN 
- ENDC 
- ENDM 


Macro calls and 


l. PUSHADR 
PUSHAL 
2. PUSHADR 
PUSHAL 
3. PUSHADR 
PUSHL 
4. PUSHADR 
PUSHL 
%MACRO—W-GENWRN , 
5. PUSHADR 
PUSHL 


%MACRO-W-GENWRN , 


A WARNING MESSAGE. 


PUSHADR ADDR 
A,ADDR 


#0 


se ™e te NO Se 


ADDR 


me Se “Se Me MO We WME MEO 


ADDR 
; ADDR IS NOT AN ADDRESS 


PUSHADR 


THE FOLLOWING MACRO IS USED TO PUSH AN ADDRESS ON THE STACK. IT CHECKS 
THE OPERAND TYPE (BY USING .NTYPE) TO DETERMINE IF THE OPERAND IS AN 
IF NOT, THE MACRO SIMPLY PUSHES THE ARGUMENT ON THE STACK 


ASSIGNS OPERAND TYPE TO A 
ISOLATE ADDRESSING MODE 
IS ARGUMENT EXACTLY 0 
STACK ZERO 

EXIT FROM MACRO 


ERR TELLS IF MODE IS ADDRESS 

ERR = 0 FOR ADDRESS, 1 WHEN NOT 
IS MODE NOT LITERAL OR IMMEDIATE 
IS MODE NOT REGISTER 

IS MODE ADDRESS? 

YES, STACK ADDRESS 

NO 

THEN STACK OPERAND & WARN 


expansions of the macro defined above: 


(RO) 
(RO) 


=e Oe 


(R1) [R4] 
(R1) [R4] 


me Me 


0 
#0 


#1 ; 
#1 ; 
Generated WARNING: #1 IS 


me Me 


RO ; 
RO H 
Generated WARNING: RO IS 


VALID ARGUMENT 
YES, STACK ADDRESS 


VALID ARGUMENT 
YES, STACK ADDRESS 


IS ZERO 
STACK ZERO 


NOT AN ADDRESS 
THEN STACK OPERAND & WARN 
NOT AN ADDRESS 


NOT AN ADDRESS 
THEN STACK OPERAND & WARN 
NOT AN ADDRESS 


Note that to save space, this example is listed as it would appear if 


~SHOW BINARY, 
program. 


not .SHOW EXPANSIONS, 


was specified in the source 


MACROS 
-REPEAT 


«REPEAT-~REPEAT BLOCK DIRECTIVE 


»REPEAT repeats a block of code, a specified number of times, inline 
with other source code. The .ENDR directive specifies the end of the 
range. 


Format 


~REPEAT expression 


- ENDR 
Parameters 


expression 


An expression whose value controls the number of times the range 
is to be assembled within the program. When the expression is 
less than or equal to 0, the repeat block is not assembled. The 
expression must not contain any undefined symbols and must be an 
absolute expression (see Section 3.5). 


range 


The source text to be repeated the number of times specified by 
the value of the expression. The repeat block can contain macro 
definitions, indefinite repeat blocks, or other repeat blocks. 
-MEXIT is legal within the range. 


Example 
Macro definition: 


»MACRO COPIES STRING,NUM 
- REPEAT “NUM 

-ASCII /STRING/ 

» ENDR 

BYTE 0 

./ ENDM COPIES 


Macro calls and expansions of the macro defined above: 


l. COPIES <ABCDEF>,5 
eREPEAT 5 
eASCII /ABCDEF/ 
» ENDR 


-ASCII /ABCDEF/ 
eASCII /ABCDEF/ 
eASCII /ABCDEF/ 
eASCII /ABCDEF/ 
-ASCII /ABCDEF/ 
-BYTE 0 


Note 


= 3 
COPIES <HOW MANY 
e-REPEAT 3 
-ASCII /HOW MANY 
- ENDR 


eASCII /HOW MANY 
eASCII /HOW MANY 
eASCII /HOW MANY 
~ BYTE 0 


TIMES> 
TIMES/ 
TIMES/ 


TIMES/ 
TIMES/ 


MACROS 


7 \VARB 


The alternate form of .REPEAT is 


-REPT. 


APPENDIX A 


ASCII CHARACTER SET 


Table A-1 lists the ASCII characters and the hexadecimal code _ for 


each. 
HEX ASCII 
Code Char. 
00 


Table A-1l 
Hexadecimal/ASCII Conversion 


ASCII HEX ASCII HEX ASCII HEX 
Char. Code Char. Code Char. Code 
20 Pp 40 60 
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APPENDIX B 


VAX~11 MACRO ASSEMBLER DIRECTIVES AND LANGUAGE SUMMARY 


B.1 ASSEMBLER DIRECTIVES 


The following table summarizes the VAX-11 MACRO assembler directives. 


Table B-1l 
Assembler Directives 


Format Operation 


ADDRESS address-list Stores successive longwords of 
address data 


-ALIGN keyword [,expression] Aligns the location counter to 
the boundary specified by the 
keyword 


integer [{,expression] Aligns location counter to the 
boundary specified by (2*integer) 


string Stores the ASCII string string 
(enclosed in delimiters), 
preceded by a count byte 


string Stores the ASCII (enclosed in 
delimiters), preceded by a string 
descriptor 


eASCII string Stores the ASCII string (enclosed 
in delimiters) 


-ASCIZ string Stores the ASCII string (enclosed 
in delimiters) followed by a 0 
byte. 


~BLKA expression Reserves longwords of address 
data 

»~BLKB expression Reserves bytes for data 

~-BLKD expression Reserves quadwords for 


double~precision, floating-point 
data 





(continued on next page) 


VAX-11 MACRO ASSEMBLER DIRECTIVES AND LANGUAGE SUMMARY 


Table B-1l (Cont.) 
Assembler Directives 


Reserves longwords for 
single-precision, floating-point 
data 















Format 









-BLKF expression 





Reserves quadwords for 
floating-point data 


-BLKG expression 









Reserves octawords for 
extended-precision floating-point 
data 


»BLKH expression 






-BLKL expression Reserves longwords for data 











Reserves octawords for data 





-BLKO expression 






-BLKQ expression Reserves quadwords for data 









Reserves words for data 





-BLKW expression 


Generates successive bytes of 
data; each byte contains the 
value of the specified expression 


-BYTE expression-list 







Enables cross-referencing of all 
symbols 


-CROSS 








eCROSS symbol-list Cross-references specified 


symbols 





»-DEBUG symbol-list Makes symbol names known to the 


debugger 

















Specifies the default 
displacement length for the 
relative addressing modes 


~DEFAULT DISPLACEMENT, keyword 









-D_FLOATING literal-list Generates 8-byte, 
double-precision, floating-point 


data 


Disables function(s) specified in 
argument-list 


-DISABLE argument-list 










-DOUBLE literal-list Equivalent to .D FLOATING 





Equivalent to .DISABLE 





-DSABL argument-list 


-ENABL argument-list Equivalent to .ENABLE 









Enables function(s) specified in 
argument-list 


~ENABLE argument-list 





Indicates logical end of source 
program; optional symbol 
specifies transfer address 


e-END [symbol] 









(continued on next page) 


VAX-11 MACRO ASSEMBLER DIRECTIVES AND LANGUAGE SUMMARY 


Table B-1 (Cont.) 
Assembler Directives 


~ENDC Indicates end of conditional 
assembly block 


~ENDM [macro-name] Indicates end of macro definition 

-ENDR Indicates end of repeat block 

-ENTRY symbol [,expression] Procedure entry directive 

~ERROR [expression] ;comment Displays specified error message 

- EVEN Ensures that the current location 
counter has an even value (adds 1 
if it is odd) 


~EXTERNAL symbol-list Indicates specified symbols are 
externally defined 


~-EXTRN symbol-list Equivalent to .EXTERNAL 


-F_ FLOATING literal-list Generates 4-byte, 
Single-precision, floating point 
data 


~FLOAT literal-list Equivalent to .F_ FLOATING 


-G_FLOATING literal-list Generates 8-byte G floating-point 
data 


»-GLOBAL symbol-list Indicates specified symbols are 
global symbols 


-GLOBL Equivalent to .GLOBAL 


-H_FLOATING literal-list Generates 16-byte, extended 
precision H_ floating-point data 


- IDENT string Provides means of labeling object 
module with additional data 


-IF condition argument (s) Begins a conditional assembly 
block of source code which is 
included in the assembly only if 
the stated condition is met with 
respect to the argument(s) 
specified 


~IFF Equivalent to .IF_FALSE 

-IF_ FALSE Appears only within a conditional 
assembly block; begins block of 
code to be assembled if the 
original condition tests false 


Equivalent to .IF_TRUE 
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Table B-1l (Cont.) 
Assembler Directives 


prom rerntton 


-IFTF Equivalent to .IF TRUE FALSE 


-IF_TRUE Appears only within a conditional 
assembly block; begins block of 
code to be assembled if the 
original condition tests true 


-IF_ TRUE FALSE Appears only within a conditional 
assembly block; begins block of 
code to be assembled 


unconditionally 
-IIF condition argument(s), Acts aS a l-line conditional 
Statement assembly block where the 


condition is tested for the 
argument specified; the 
statement is assembled only if 
the condition tests true 


~IRP sym<argument list> Replaces a formal argument with 
successive actual arguments 
specified in an argument list 


~IRPC sym,<string> Replaces a formal argument with 
successive single characters 
specified in string 


»~LIBRARY macro-library-name Specifies a macro library 
eLIST [argument-list] Equivalent to .SHOW 
~LONG expresSion-list Generates successive longwords of 


data; each longword contains the 
value of the specified 
expression. 


»MACRO macro-name ,argument-list| Begins a macro definition 


»MASK symbol [,expression] Reserves a word for and copies a 
register save mask 


~MCALL macro-name-list Specifies the system and/or 
user-defined macros in libraries 
that are required to assemble the 
source program 


-MDELETE macro-name~list Deletes from memory the macro 
definitions of the macros in the 
list 

-MEXIT Exits from the expansion of a 


macro before the end of the macro 
is encountered 
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Table B-1 (Cont.) 
Assembler Directives 


promt operation 


»~NARG symbol Determines the number of 
arguments in the current macro 
call 





















Determines the number of 
characters in a specified 
character string 


~-NCHR symbol,<string> 











-NLIST [argument-list] Equivalent to .NOSHOW 


-NOCROSS Disables cross-referencing of all 


symbols 





~-NOCROSS symbol-list Disables cross-referencing of 


specified symbols 








-NOSHOW Decrements listing level count 
















-NOSHOW argument-list Controls listing of macros and 


conditional assembly blocks 





-NTYPE symbol,operand Can appear only within a macro 
definition; equates the symbol 
to the addressing mode of the 


specified operand 








-OCTA literal Stores 16 bytes of data 


-OCTA symbol Stores 16 bytes of data 





Ensures that the current location 
counter has an odd value (adds 1 
if it is even) 





-ODD 
















-OPDEF opcode value, 
operand-descriptor-list 


Defines an opcode and its 
operand list 








-PACKED decimal~string [,Symbol]} Generates packed decimal data, 2 


digits per byte 





- PAGE Causes the assembly listing to 
skip to the top of the next page, 


and to increment the page count 









-PRINT [expression] ;comment Displays the specified message 


»PSECT Begins or resumes the blank 


program section 














»~PSECT section-name 
argument-list 


Begins or resumes a user-defined 
program section 


(continued on next page) 
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Table B-1 (Cont.) 
Assembler Directives 


rome | peratton 


-QUAD literal 
QUAD symbol 
eREF1 operand 
»-REF2 operand 
»-REF4 operand 
e-REF8 operand 
e-REF16 operand 


»REPEAT expression 


-REPT 
- RESTORE 


»RESTORE PSECT 


-SAVE [LOCAL BLOCK] 


~SAVE_PSECT [LOCAL BLOCK] 


-SBTTL comment-string 
- SHOW 


-SHOW argument-list 
-SIGNED BYTE expression-list 
~SIGNED WORD expression-list 


»SUBTITLE comment-—string 


earner ome 





Stores 8 bytes of data 







Stores 8 bytes of data 





Generates byte operand 









Generates word operand 
Generates longword operand 
Generates quadword operand 


Generates octaword operand 



















Begins a repeat block; the 
section of code up to the next 
e-ENDR directive is repeated the 
number of times specified by the 
expression 


Equivalent to .REPEAT 


Equivalent to .RESTORE PSECT 





Restores program section context 
from the program section context 
stack 


Equivalent to .SAVE PSECT 













Saves current program section 
context on the program section 
context stack 
Equivalent to .SUBTITLE 


Increments listing level count 


Controls listing of macros and 
conditional assembly blocks 





Stores successive bytes (8 bits) 
of signed data 





Stores successive words (16 bits) 
of signed data 


Causes the specified string to be 
printed as part of the assembly 
listing page header; the string 
component of each .SUBTITLE is 
collected into a table of 
contents at the beginning of the 
assembly listing 
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Table B-1l (Cont.) 
Assembler Directives 


-TITLE module-name Assigns the first 15 characters in 
comment-string the string as an object module 
name and causes the string to 
appear on each page of the 
assembly listing 


~TRANSFER symbol Directs the linker to redefine 
the value of the global symbol 
for use in a Shareable image 


~WARN [expression] ;comment Displays specified warning 
message 


»WEAK symbol-list . Indicates that each of the listed 
symbols has the weak attribute 


~-WORD expression-list Generates successive words of 
data; each word contains the 
value of the corresponding 
specified expression 





B.2 SPECIAL CHARACTERS 


The following table summarizes the VAX~-11 MACRO special characters. 


Table B-2 
Special Characters Used in VAX-11 MACRO Statements 


Character Character Name Function(s) 


Underline Character in symbol names 


Dollar sign Character in symbol names 

Period Character in symbol names, 
current location counter, and 
decimal point 

Colon Label terminator 


Equal sign Direct assignment operator and 
macro keyword argument terminator 


Tab Field terminator 
Space Field terminator 


Number sign Immediate addressing mode 
indicator 
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Table B-2 (Cont.) 
Special Characters Used in VAX-11 MACRO Statements 






Character Name 






























At sign 


Comma 
Semicolon 


Plus sign 


Minus sign 


Asterisk 


Slash 
Ampersand 


Exclamation 
point 


Backslash 


Circumflex 


Square brackets 


Parentheses 


Angle brackets 


Question mark 


Apostrophe 


Percent sign 


soe 


Function (s) 


Deferred addressing mode 
indicator and arithmetic shift 
operator 


Field, operand, and item 
separator 


Comment field indicator 
Autoincrement addressing mode 
indicator, unary plus operator, 
and arithmetic addition operator 
Autodecrement addressing mode 
indicator, unary minus operator, 
arithmetic subtraction operator, 
and line continuation indicator 


Arithmetic multiplication 
operator 


Arithmetic division operator 
Logical AND operator 

Logical inclusive OR operator 
Logical exclusive OR and numeric 
conversion indicator in macro 


arguments 


Unary operator indicator and 
macro argument delimiter 


Index addressing mode and repeat 
count indicators 


Register deferred addressing mode 
indicators 


Argument or expression grouping 
delimiters 


Created label indicator in macro 
arguments 


Macro argument concatenation 
indicator 


Macro string operators 


VAX-11 MACRO ASSEMBLER DIRECTIVES AND LANGUAGE SUMMARY 


B.3 OPERATORS 


B.3.1 Unary Operators 


The following table summarizes the VAX-11l1 MACRO unary operators. 


Table B-3 
Unary Operators 


Unary Operator 
Operator Name Example 


Plus sign 


Minus sign 


Binary *B11000111 


Decimal “D127 


Octal “034 


Hexadecimal “XFCF9 


ASCII “A/ABC/ 


Register mask “M<R3,R4,R5> 


Floating point 


Complement 


Effect 


Results in the positive 
value of A:s(default) 


Results in the negative 
(2's complement) value 
of A 


Specifies that 11000111 
is a binary number 


Specifies that 127 is a 
decimal number 


Specifies that 34 is an 
octal number 


Specifies that FCF9 is 
a hexadecimal number 


Produces an ASCII 
string; the characters 
between the matching 
delimiters are 
converted to ASCII 
representation 


Specifies the registers 
R3, R4, and R5 in the 
register mask 


Specifies that 3.0 is a 
floating-point number 


Produces the l's 
complement value of 24 
(decimal) 
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B.3.2 Binary Operators 


The following table summarizes the VAX-11 MACRO binary operators. 


Table B-4 
Binary Operators 





Binary Operator 
Operator Name Example Operation 


Plus sign A+B Addition 

Minus sign A-B Subtraction 

Asterisk A*B Multiplication 

Slash A/B Division 

At sign A@B Arithmetic Shift 
Ampersand A&B Logical AND 
Exclamation point A!B Logical inclusive OR 
Backslash A\B Logical exclusive OR 





B.3.3 Macro String Operators 
The following table summarizes the macro string operators. These 


operators can be used only in macros. 


Table B-5 
Macro String Operators 









Function 






%LENGTH (String) Returns the length of the 


string 












%LOCATE (stringl,string2[,symbol]) Locates the substring 
Stringl within string2 
Starting the search at the 
character position specified 


by symbol 








%EXTRACT (symboll,symbol2,string) 






Extracts a substring from 
string that begins at 
character position specified 
by symboll and has a length 
specified by symbol2 














B-10 
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B.4 ADDRESSING MODES 


The following table summarizes the VAX-11 MACRO addressing modes. 


Table B-6 
Addressing Modes 





Hexa- 
Addressing decimal 
Type Mode Format + Value Description 
General Register Rn 5 Register contains the operand 
Register 
Register (Rn) 6 Register contains the address of 
Deferred the operand 
Autoincrement (Rn) + 8 Register contains the address of the 
operand; the processor 
increments the register contents 
by the size of the operand data 
type 
Autoincrement @(Rn)+ 9 Register contains the address of 
Deferred the operand address; the 
processor increments the 
register contents by 4 
Autodecrement - (Rn) 7 The processor decrements the 
register contents by the size 
of the operand data type; the 
register then contains the 
address of the operand 
Displacement dis (Rn) The sum of the contents of the 
B“dis(Rn) A register and the displacement is 
wW°dis(Rn) c the address of the operand; B7*, 
L*dis(Rn) E w*,and L* indicate byte, word, 
and longword displacement, 
respectively 
Displacement @dis (Rn) The sum of the contents of the 
Deferred @B“dis (Rn) B register and the displacement is 
@wW*dis(Rn) D the address of the operand 
@L*dis (Rn) F address; B*, W*, and L* 
indicate byte, word, and 
longword displacement, 
respectively 
General Literal #literal The literal specified is the 
Register S“#literal 0-3 | the operand; the literal is 
(Cont.) stored as a short literal 
Program Relative address The address specified is the 
Counter B“address A address of the operand; the 
Waddress Cc address specified is stored as a 
L* address E displacement from PC; B*, W%, 
and L* indicate byte, word, and 
longword displacement, 
respectively 
Relative @address The address specified is the address 
Deferred @B“address B of the operand address; the address 
@W* address D specified is stored as a 
@L“ address F displacement from PC; B*, W’, 
and L* indicate byte, word, and 
longword displacement, 
respectively 
Absolute @#address 9 The address specified is the address 
of the operand; the address 
specified is stored as an 
absolute virtual address (not as 
a displacement) 
Immediate #literal The literal specified is the 
I°#literal 8 operand; the literal is stored 
as a byte, word, longword, or 
quadword 
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Table B-6 (Cont.) 
Addressing Modes 


Addressing 
Mode 





General G*address 


base-mode [Rx] 


Branch address 


l. Key: 


Rn 
Any general register RO 
register can be used in 


Rx 
Any general register RO 
register can be used 
the Rn specified in the 
Section 4.3). 


dis 
An 


address 





Indexable? 


Description 





























The address specified is the 
address of the operand; if the 
address is defined as 
relocatable, the linker stores 
the address as a displacement 
from PC; if the address is 
defined as an absolute virtual 
address, the linker stores the 
address as an absolute value 


The base-mode specifies the base 
address and the register 
specifies the index; the sum of 
the base address and the product 
of the contents of Rx and the 
size of the operand data type is 
the address of the operand; 
base-mode can be any addressing 
mode except register, immediate, 
literal, index, or branch 


The address specified is the 
operand; this address is stored 
as a displacement to PC; branch 
mode can only be used with the 








through R12. or SP 


place of Rn. 


Note that the AP, FP, 


through R12. Note that the AP, FP, or SP 
in place of Rx. Rx cannot be the same as 
base-mode for certain base modes’ (see 


expression specifying a displacement. 


An expression specifying an address. 


literal 
An 


expression, an integer constant, or a floating-point constant. 


APPENDIX C 


PERMANENT SYMBOL TABLE 


The permanent symbol table (PST) contains the symbols that VAX-11 
MACRO automatically recognizes. These symbols consist of both opcodes 
and assembler directives. Sections C.1 and C.2 below present’ the 
opcodes (instruction set) in alphabetical and numerical order, 
respectively. Appendix B (in Section B.1) presents the assembler 
directives. 


The VAX-1l1 Architecture Handbook provides a detailed description of 
the instruction set. 


C.1 OPCODES (ALPHABETIC ORDER) 


Hexadecimal 
Value Mnemonic Functional Name 
9D ACBB Add compare and branch byte 
6F ACBD Add compare and branch D_ floating 
4F ACBF Add compare and branch F floating 
4FFD ACBG Add compare and branch G floating 
6FFD ACBH Add compare and branch H_ floating 
Fl ACBL Add compare and branch long 
3D ACBW Add compare and branch word 
58 ADAWI Add aligned word interlocked 
80 ADDB2 Add byte 2 operand 
81 ADDB3 Add byte 3 operand 
60 ADDD2 Add D-floating 2 operand 
61 ADDD3 Add D-floating 3 operand 
40 ADDF2 Add F floating 2 operand 
41 ADDF3 Add F floating 3 operand 
40FD ADDG2 Add G floating 2 operand 
41FD ADDG3 Add G floating 3 operand 
60FD ADDH2 Add H floating 2 operand 
61FD ADDH3 Add H_ floating 3 operand 
co ADDL2 Add long 2 operand 
Cl ADDL3 Add long 3 operand 
20 ADDP4 Add packed 4 operand 
21 ADDP6 Add packed 6 operand 
AO ADDW2 Add word 2 opetand 
Al ADDW3 Add word 3 operand 
D8 ADWC Add with carry 
F3 AOBLEQ Add one and branch on less or equal 
F2 AOBLSS Add one and branch on less 
78 ASHL Arithmetic shift long 
F8 ASHP Arithmetic shift and round packed 
79 ASHQ Arithmetic shift quad 


Hexadecimal 


Value 


El 
E5 
E7 
E3 
EO 
E4 
E2 
E6 


1E 
1F 
13 
13 
18 
1E 
14 
1A 


8A 
8B 
CA 
CB 
B9 
AA 
AB 
88 


89 
c8 
cg 
B8 
A8 
A9 
93 
D3 


B3 
E9 
E8 
15 
1B 
19 
1F 
12 


12 
03 
ll 
31 
10 
30 
1c 
1D 


Mnemonic 


BBC 
BBCC 
BBCCI 
BBCS 
BBS 
BBSC 
BBSS 
BBSSI 


BCC 

BCS 

BEQL 
BEQLU 
BGEQ 
BG EQU 
BGTR 
BGTRU 


BICB2 
BICB3 
BICL2 
BICL3 
BICPSW 
BICW2 
BICW3 
BISB2 


BISB3 
BISL2 
BISL3 
BISPSW 
BISW2 
BISW3 
BITB 
BITL 


BITW 
BLBC 
BLBS 
BLEQ 
BLEQU 
BLSS 
BLSSU 
BNEQ 


BNEQU 
BPT 
BRB 
BRW 
BSBB 
BSBW 
BVC 
BVS 


CALLG 
CALLS 
CASEB 
CASEL 
CASEW 


Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 


Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 


Fu 


on 
on 
on 
on 
on 
on 
on 
on 


on 
on 
on 
on 
on 
on 
on 
on 


PERMANENT SYMBOL TABLE 


nctional Name 


bit clear 

bit clear and clear 

bit clear and clear interlocked 
bit clear and set 

bit set 

bit set and clear 

bit set and set 

bit set and set interlocked 


carry clear 

carry set 

equal 

equal unsigned 

greater or equal 

greater or equal unsigned 
greater 

greater unsigned 


Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 


clear 
clear 
clear 
clear 
clear 
clear 
clear 


byte 2 
byte 3 
long 2 
long 3 


operand 
operand 
operand 
operand 


program status 


word 2 
word 3 


operand 
operand 


word 


set 


set 
set 
set 


byte 2 


byte 3 
long 2 
long 3 


operand 


operand 
operand 
operand 


Bit set 
Bit set 
Bit set 


Pp 
Ww 


Ww 


rogram status word 
ord 2 operand 
ord 3 operand 


Bit test byte 
Bit test long 


Bit test word 


Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 


Branch 


on 
on 
on 
on 
on 
on 
on 


on 


low bit clear 

low bit set 

less or equal 

less or equal unsigned 
less 

less unsigned 

not equal 


not equal unsigned 


Break point trap 


Branch 
Branch 
Branch 
Branch 
Branch 
Branch 


Call wi 
Call wi 
Case by 
Case lo 
Case wo 


with byte displacement 

with word displacement 

to subroutine with byte displacement 
to subroutine with word displacement 
on overflow clear 

on overflow set 

th general argument list 

th stack 

te 

ng 

rd 


Hexadecimal 
Value 


BD 
BC 
BE 
BF 
94 


4CFD 
6CFD 
98 
99 
68 


76 
32FD 
6A 
69 
48 
56 
99FD 
98FD 
4A 
49 
48FD 
33FD 
56FD 
4AFD 
49FD 


68FD 
F7FD 
F6FD 
76FD 
6AFD 
69FD 
F6 


PERMANENT SYMBOL TABLE 


Mnemonic Functional Name 

CHME Change mode to executive 

CHMK Change mode to kernel 

CHMS Change mode to supervisor 

CHMU Change mode to user 

CLRB Clear byte 

CLRD Clear D floating 

CLRF Clear F floating 

CLRG Clear G floating 

CLRH Clear H floating 

CLRL Clear long 

CLRO Clear octa 

CLRQ Clear quad 

CLRW Clear word 

CMPB Compare byte 

CMPC3 Compare character 3 operand 
CMPC5 Compare character 5 operand 

CMPD Compare D floating 

CMPF Compare F floating 

CMPG Compare G floating 

CMPH Compare H floating 

CMPL Compare long 

CMPP3 Compare packed 3 operand 

CMPP4 Compare packed 4 operand 

CMPV Compare field 

CMPW Compare word 

CMPZV Compare zero-extended field 

CRC Calculate cyclic redundancy check 
CVTBD Convert byte to D floating 

CVTBF Convert byte to F floating 

CVTBG Convert byte to G floating 

CVTBH Convert byte to H floating 

CVTBL Convert byte to long 

CVTBW Convert byte to word 

CVTDB Convert D_ floating to byte 

CVTDF Convert D_ floating to F_ floating 
CVTDH Convert D floating to H floating 
CVTDL Convert D floating to long 
CVTDW Convert D floating to word 

CVTFB Convert F floating to byte 

CVTFD Convert F floating to D floating 
CVTFG Convert F floating to G floating 
CVTFH Convert F floating to H floating 
CVTFL Convert F floating to long 

CVTFW Convert F floating to word 

CVTGB Convert G floating to byte 

CVTGF Convert G floating to F floating 
CVTGH Convert G floating to H floating 
CVTGL Convert G floating to long 
CVTGW Convert G floating to word 

CVTHB Convert H floating to byte 

CVTHD Convert H floating to D floating 
CVTHF Convert H floating to F floating 
CVTHG Convert H floating to G floating 
CVTHL Convert H_ floating to long 
CVTHW Convert H_ floating to word 

CVTLB Convert long to byte 


Hexadecimal 
Value 


6E 
4E 
4EFD 
6EFD 
F9 
F7 
36 
08 
24 
6B 


4B 
4BFG 
6BFD 
09 
26 
33 
6D 
4D 
4DFD 
6DFD 
32 
97 


D7 
B7 
86 
87 
66 


Mnemonic 


CVTLD 
CVTLF 
CVTLG 
CVTLH 
CVTLP 
CVTLW 
CVTPL 
CVTPS 
CVTPT 
CVTRDL 


CVTRFL 
CVTRGL 
CVTRHL 
CVTSP 
CVTTP 
CVTWB 
CvTWD 
CVTWF 
CVTWG 
CV TWH 
CVTWL 
DECB 


DECL 
DECW 
DIVB2 
DIVB3 
DIVD2 
DIVD3 
DIVF2 
DIVF3 
DIVG2 
DIVG3 
DIVH2 
DIVH3 
DIVL2 
DIVL3 
DIVP 
DIVW2 
DIVW3 
EDITPC 
EDIV 
EMODD 


EMODF 
EMODG 
EMODH 
EMUL 
EXTV 
EXTZV 
FEC 
FFS 
HALT 
INCB 


INCL 
INCW 
INDEX 


Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 


Convert 


Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Convert 
Decreme 


Decreme 
Decreme 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Divide 
Edit pa 
Extende 
Extende 


Extende 
Extende 
Extende 
Extende 
Extract 
Extract 
Find fi 
Find fi 
Halt 

Increme 


Increme 
Increme 


PERMANENT SYMBOL TABLE 


Functional Name 


long to D floating 

long to F floating 

long to G floating 

long to H floating 

long to packed 

long to word 

packed to long 

packed to leading separate 
packed to trailing 

rounded D floating to long 


rounded F floating to long 
rounded G floating to long 
rounded H floating to long 
leading separate to packed 
trailing to packed 

word to byte 

word to D floating 

word to F floating 

word to G floating 

word to H floating 

word to long 
nt byte 


nt long 
nt word 
byte 2 operand 
byte 3 operand 


D floating 2 operand 
D floating 3 operand 
F floating 2 operand 
F floating 3 operand 
G floating 2 operand 
G floating 3 operand 
H floating 2 operand 
H floating 3 operand 


lang 2 operand 

long 3 operand 
packed 

word 2 operand 

word 3 operand 

cked to character 

d divide 

d modulus D_ floating 


d modulus F floating 
d modulus G floating 
d modulus H_ floating 
d multiply 

field 

zero-extended field 
rst clear bit 

rst set bit 


nt byte 


nt long 
nt word 


Index calculation 


Hexadecimal 
Value 


PERMANENT SYMBOL TABLE 


Mnemonic Functional Name 

INSQHI Insert into queue at head, interlocked 
INSQOTI Insert into queue at tail, interlocked 
INSQUE Insert into queue 

INSV Insert field 

JMP Jump 

JSB Jump to subroutine 

LDPCTX Load program context 

LOCC Locate character 

MATCHC Match characters 

MCOMB Move complemented byte 

MCOML Move complemented long 

MCOMW Move complemented word 

MFPR Move from processor register 
MNEGB Move negated byte 

MNEGD Move negated D. floating 

MNEGF Move negated F floating 

MNEGG Move negated G floating 

MNEGH Move negated H floating 

MNEGL Move negated long 

MNEGW Move negated word 

MOVAB Move address of byte 

MOVAD Move address of D floating 
MOVAF Move address of F floating 

MOV AG Move address of G floating 
MOVAH Move address of H_ floating 
MOVAL Move address of long 

MOVAO Move address of octa 

MOVAQ Move address of quad 

MOVAW Move address of word 

MOVB Move byte 

MOVC3 Move character 3 operand 

MOVC5 Move character 5 operand 

MOVD Move D floating 

MOVF Move F floating 

MOVG Move G floating 

MOVH Move H floating 

MOVL Move long 

MOVO Move data 

MOVP Move packed 

MOVPSL Move program status longword 
MOVQ Move quad 

MOVTC Move translated characters 
MOVTUC Move translated until character 
MOVW Move word 

MOVZBL Move zero-extended byte to long 
MOV ZBW Move zero-extended byte to word 
MOV ZWL Move zero-extended word to long 
MTPR Move to processor register 
MULB2 Multiply byte 2 operand 

MULB3 Multiply byte 3 operand 

MULD2 Multiply D floating 2 operand 
MULD3 Multiply D floating 3 operand 
MULF2 Multiply F_ floating 2 operand 
MULF3 Multiply F floating 3 operand 
MULG2 Multiply G floating 2 operand 
MULG3 Multiply G_ floating 3 operand 


Hexadecimal 


Value 


64FD 
65FD 


PERMANENT SYMBOL TABLE 


Mnemonic Functional Name 
MULH2 Multiply H_ floating 2 operand 
MULH3 Multiply H floating 3 operand 
MULL2 Multiply long 2 operand 
MULL3 Multiply long 3 operand 


MULP Multiply packed 

MULW2 Multiply word 2 operand 
MULW3 Multiply word 3 operand 
NOP No operation 


POLYD Evaluate polynomial D floating 
POLYF Evaluate polynomial F floating 
POLYG Evaluate polynomial G floating 
POLYH Evaluate polynomial H floating 
POPR Pop registers = 

PROBER Probe read access 

PROBEW Probe write access 

PUSHAB Push address of byte 

PUSHAD Push address of D floating 

PUSHAF Push address of F floating 

PUSHAG Push address of G floating 

PUSHAH Push address of H floating 

PUSHAL Push address of long 

PUSHAO Push address of octa 

PUSHAQ Push address of quad 

PUSHAW Push address of word 

PUSHL Push long 

PUSHR Push registers 

REI Return from exception or interrupt 
REMOHI Remove from queue at head, interlocked 
REMOTI Remove from queue at tail, interlocked 
REMQUE Remove from queue 

RET Return from called procedure 

ROTL Rotate long 

RSB Return from subroutine 

SBWC Subtract with carry 

SCANC Scan for character 

SKPC Skip character 

SOBGEQ Subtract one and branch on greater or equal 
SOBGTR Subtract one and branch on greater 
SPANC Span characters 

SUBB2 Subtract byte 2 operand 

SUBB3 Subtract byte 3 operand 

SUBD2 Subtract D floating 2 operand 
SUBD3 Subtract D floating 3 operand 
SUBF2 Subtract F floating 2 operand 
SUBF3 Subtract F floating 3 operand 
SUBG2 Subtract G floating 2 operand 
SUBG3 Subtract G floating 3 operand 
SUBH2 Subtract H floating 2 operand 
SUBH3 Subtract H floating 3 operand 
SUBL2 Subtract long 2 operand 

SUBL3 Subtract long 3 operand 

SUBP4 Subtract packed 4 operand 

SUBP6 Subtract packed 6 operand 

SUBW2 Subtract word 2 operand 

SUBW3 Subtract word 3 operand 


Hexadecimal 
Value 


07 
o> 
73 
53 
53FD 
73FD 
D5 
B5 
FC 


8C 
8D 
CC 
CD 
AC 
AD 


PERMANENT SYMBOL TABLE 


Mnemonic Functional Name 
SVPCTX Save process context 

TSTB Test byte 

TSTD Test D_ floating 

TSTF Test F floating 

TSTG Test G floating 

TSTH Test H floating 

TSTL Test long 

TSTW Test word 

XFC Extended function call 
XORB2 Exclusive-OR byte 2 operand 
XORB3 Exclusive-OR byte 3 operand 
XORL2 Exclusive-OR long 2 operand 
XORL3 Exclusive-OR long 3 operand 
XORW2 Exclusive-OR word 2 operand 
XORW3 Exclusive-OR word 3 operand 


C.2 


HEX 
Value 


00 
01 
02 
03 
04 
05 
06 
07 
08 
09 
OA 
OB 
oc 
oD 
0E 
OF 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
1A 
1B 
1c 
1D 
1E 
1F 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
2A 
2B 
2c 
2p 
2E 
2F 


OPCODES (NUMERIC ORDER) 


Instruction 


HALT 
NOP 
RET 
BPT 
RET 
RSB 
LDPCTX 
SVPCTX 
CVTPS 
CVTSP 
INDEX 
CRC 
PROBER 
PROBEW 
INSQUE 
REMQUE 
BSBB 
BRB 
BNEQ, BNEQU 
BEQL, BEQLU 
BGTR 
BLEQ 
JSB 
JMP 
BGEQ 
BLSS 
BGTRU 
BLEQU 
BVC 
BVS 
BCC, BGEQU 
BCS, BLSSU 
ADDP4 
ADDP6 
SUBP 4 
SUBP6 
CVTPT 
MULP 
CVTTP 
DIVP 
MOVC3 
CMPC3 
SCANC 
SPANC 
MOVC5 
CMPC5 
MOVTC 
MOVTUC 


HEX 
Value 


30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
3A 
3B 
3C 
3D 
3E 
3F 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
4A 
4B 
4c 
4D 
4E 
4F 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
5A 
5B 
5c 
5D 
5E 
5F 


Instruction 


BSBW 
BRW 
CVTWL 
CVTWB 
MOVP 
CMPP3 
CVTPL 
CMPP4 
EDITPC 
MATCHC 
Locc 
SKPC 
MOVZWL 
ACBW 
MOVAW 
PUSHAW 
ADDF 2 
ADDF3 
SUBF2 
SUBF3 
MULF 2 
MULF3 
DIVF2 
DIVF3 
CVTFB 
CVTFW 
CVTFL 
CVTRFL 
CVTBF 
CVTWF 
CVTLF 
ACBF 
MOVF 
CMPF 
MNEGF 
TSTF 
EMODF 
POLYF 
CVTFD 
reserved 
ADAWI 
reserved 
reserved 
reserved 
INSQHT 
INSQTI 
REMOQHT 
REMQTI 


HEX 
Value 


60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
6A 
6B 
6C 
6D 
6E 
6F 
70 
71 
72 
73 
74 
75 
76 
77 
78 


Instruction 


ADDD2 
ADDD3 
SUBD2 
SUBD3 
MULD2 
MULD3 
DIVD2 
DIVD3 
CVTDB 
CVTDW 
CVTDL 
CVTRDL 
CVTBD 
CVTWD 
CVTLD 
ACBD 
MOVD 
CMPD 
MNEGD 
TSTD 
EMODD 
POLYD 
CVTDF 
reserved 
ASHL 
ASHQ 
EMUL 
EDIV 
CLRD, CLRQ, CLRG 
MOVO 
MOVAD, MOVAQ, MOVAG 


AC 


AE 


PUSHAD, PUSHAQ, PUSHAG AF 


ADDB2 
ADDB3 
SUBB2 
SUBB3 
MULB2 
MULB3 
DIVB2 
DIVB3 
BISB2 
BISB3 
BICB2 
BICB3 
XORB2 
XORB3 
MNEGB 
CASEB 


BO 
BL 
B2 


Instruction 


MOVB 
CMPB 
MCOMB 
BITB 
CLRB 
TSTB 
INCB 
DECB 
CVTBL 
CVTBW 
MOVZBL 
MOVZBW 
ROTL 
ACBB 
MOVAB 
PUSHAB 
ADDW2 
ADDW3 
SUBW2 
SUBW3 
MULW2 
MULW3 
DIVW2 
DIVW3 
BISW2 
BISW3 
BICW2 
BICW3 
XORW2 
XORW3 
MNEGW 
CASEW 
MOVW 
CMPW 
MCOMW 
BITW 
CLRW 
TSTW 
INCW 
DECW 
BISPSW 
BICPSW 
POPR 
PUSHR 
CHMK 
CHME 
CHMS 
CHMU 


Instruction 


ADDL2 
ADDL3 
SUBL2 
SUBL3 
MULL2 
MULL3 
DIVL2 
DIVL3 
BISL2 
BISL3 
BICL2 
BICL3 
XORL2 
XORL3 
MNEGL 
CASEL 
MOVL 
CMPL 
MCOML 
BITL 
CLRF, CLRL 
TSTL 
INCL 
DECL 
ADWC 
SBWC 
MTPR 
MFPR 
MOVPSL 
PUSHL 
MOVAF, MOVAL 
PUSHAF, PUSHAL 
BBS 
BBC 
BBSS 
BBCS 
BBSC 
BBCC 
BBSSI 
BBCCI 
BLBS 
BLBC 
FFS 
FFC 
CMPV 
CMPZV 
EXTV 
EXTZV 


HEX 
Value 


Instruction 


INSV 
ACBL 
AOBLSS 
AOBLEQ 
SOBGEQ 
SOBGTR 
CVTLB 
CVTLW 


XFC 
reserved 
reserved 
reserved 
CVTDH 
CVTGF 
ADDG2 
ADDG3 
SUBG2 
SUBG3 
MULG2 
MULG3 
DIVG2 
DIVG3 
CVTGB 
CVTGW 
CVTGL 
CVTRGL 
CVTBG 
CVTWG 
CVTLG 
ACBG 
MOVG 
CMPG 
MNEGG 
TSTG 
EMODG 
POLYG 
CVTGH 
ADDH2 
ADDEH3 
SUBH2 
SUBH3 
MULH2 
MULEH3 
DIVH2 


HEX 
Value 


67FD 
68FD 
69FD 
6AFD 
6BFD 
6CFD 
6DFD 
6EFD 
6FFD 
70FD 
71FD 
72FD 
73FD 
74FD 
75FD 
76FD 
7CFD 
7DFD 
7EFD 
7FFD 
98FD 
99FD 
F6FD 
F7FD 


Instruction 


DIVH3 
CVTHB 
CVTHW 
CVTHL 
CVTRHL 
CVTBH 
CVTWH 
CVTLH 
ACBH 

MOVE 

CMPH 
MNEGH 
TSTH 
EMODH 
POLYH 
CVTHG 
CLRH, CLRO 
MOVvO 
MOVAH, MOVAO 


PUSHAH, PUSHAO 


CVTFH 
CVTFG 
CVTHF 
CVTHD 


HTqVL IOGWAS LNINVWYdd 


APPENDIX D 


HEXADECIMAL/DECIMAL CONVERSION 


Table D-1 lists the decimal value for each possible hexadecimal value 
in each byte of a _ longword. The following sections contain 


instructions to use the table to convert hexadecimal numbers to 
decimal and vice versa. 


D.1 HEXADECIMAL TO DECIMAL 


For each integer position of the hexadecimal value, locate’ the 
corresponding column integer and record its decimal equivalent in the 
converSion table. Add the decimal equivalent to obtain the decimal 
value. 


For example: 


DO500AD0 (16) = ?(10) 
DO0000000 = 3,489,660,928 
500000 = 5,242,880 
A00 = 2,560 
DO = 208 
DO500AD0 = 3,494,904,576 


D.2 DECIMAL TO HEXADECIMAL 


Step 1: locate in the conversion table the largest decimal value that 
does not exceed the decimal number to be converted. Step 2: record 
the hexadecimal equivalent followed by the number of Os that 
corresponds to the integer column minus 1. Step 3: subtract the 
table decimal value from the decimal number to be converted. Step 4: 
repeat steps 1 through 3 until the subtraction balance equals 0. Add 
the hexadecimal equivalents to obtain the hexadecimal value. 


Example: 


D.3 


22,466 (10) 


20,480 
1,792 
192 

2 


22,466 


HEXADECIMAL/DECIMAL CONVERSION 


?(16) 


5000 
700 
co 


57C2 


POWERS OF 2 AND 16 


This section lists the decimal values 
values are often useful in converting 


Powers 


2**n 


256 

a 
1024 
2048 
4096 
8192 
16384 
32768 
65536 
131072 
262144 
524288 
1048576 
2097152 
4194304 
8 388608 
16777216 


of 2 


22,466 
-~20,480 


1,986 
so 1.799 


194 


= 192 


of powers of 2 and 16, These 
decimal numbers to hexadecimal. 


16 


Powers of 


16*¥*¥n 


1 

16 

256 

4096 

65536 

1048576 

16777216 
248435456 
4294967296 
68719476736 
1099511627776 
17592186044416 
281474976710654 
4503599627370496 
720575940379279 36 
1152921504605846976 


S 


WAN NHB WDNHOeHE SD 


HEX 


HQHmOAWPWOYNRHUPWNHE OC 


DEC 


0 

268,435,456 
536,870,912 
805,306,368 
1,073,741,824 
1,342,177,280 
1,610,612,736 
1,879,048,192 
2,147,483,643 
2,415,919,104 
2,684,354,560 
2,952,790,016 
3,221,225,472 
3,489 ,660,928 
3,758,096,384 
4,026,531,840 


mG 
tt 
* 


QHHOAWPOOYNIRHDUBWNHEC 


DEC 


0 
16,777,216 
33,554,432 
50,331,648 
67,108,864 
83,886,080 

100,663,296 
117,440,512 
134,217,728 
150,994,944 
167,772,160 
184,549,376 
201,326,592 
218,103,808 
234,881,024 
251,658,240 


Table D-1l 


Hexadecimal/Decimal Conversion 


HEX 


YomooANOWP WO OMOYIRHDNAPWNEC 


DEC 


0 
1,048,576 
2,097,152 
3,145,728 
4,194,304 
5,242,880 
6,291,456 
7,340,032 
8,388,608 
9,437,184 

10,485,760 
11,534,336 
12,582,912 
13,631,488 
14,680,064 
15,728,640 


HEX 


NQNMmoOAWPOMDNHDUPWHE CSC 


DEC 


0 
65,536 
131,072 
196,608 
262,144 
327,680 
393,216 
458,752 
524,288 
589,824 
655,360 
720,896 
786,432 
851,968 
917,504 
983,040 


YOWmOANAWYPYP OCHNHDNABWNHEO 


HEX 


DEC 


0 
4,096 
8,192 

12,288 

16,384 

20,480 

24,576 

28,672 

32,768 

36,864 

40,960 

45,056 

49,152 

53,248 

57,344 

61,440 


HEX 


YmoAQWP WO WYMAN PWNHHO 


DEC 


0 

256 
512 
768 
1,024 
1,280 
1.3536 
Bee 
2,048 
2,304 
2,560 
2,816 
3,072 
3,328 
3,584 
3,840 


HEX 


YHWOANAWP OWMAKHNSWNH OC 


DEC 


0 
16 
32 
48 
64 
80 
96 

112 
128 
144 
160 
176 
192 
208 
224 
240 


HEX DEC 
0 0 
1 1 
2 2 
3 3 
4 4 
S) 5 
6 6 
7 7 
8 8 
9 9 
A 10 
B ll 
Cc 12 
D 13 
E 14 
F 15 


SS i. en i. ns” iS Ce 


- 
LONGWORD 


BYTE 


WORD 


BYTE 


BYTE 


WORD 


BYTE 


NOISYAANOD IWWID9C/IWWIOFGVXGH 


INDEX 


A 


“A operator, 3-11, 3-13 


Absolute, 
index mode, 4-15, 4-17 


program sections, 5-46, 5-48 
ABS program section attribute, 
5-48 
Accuracy of floating-point 
numbers, 3-4 
Addition, 3-15 
Address data, r 
initializing memory with, 5-3 
reserving memory for, 5-9 
-ADDRESS directive, 5-3 
Address, Starting, 5-21, 5-22 
Address, transfer, 5-20, 5-21 
Addressing modes, 2-3, 4-1 
through 4-18 
summary of, 4-2 through 4-4, 
B-11 through B-13 


-ALIGN directive, 5-4, 5-5 
Alignment, 
data, 5-4, 5-5 
location counter, 5-4, 5-5, 
5-24, 5-41 


program section, 5-47, 5-50 
AMA argument, 5-18 
AND operator, 3-16 
AP register, 3-5 
Argument, 
concatenation in macros, 
Macro, 6-1 through 6-8 
pointer, 3-5 
Arithmetic shift, 
operator, 3-16 
Arithmetic trap enable, 
eASCIC directive, 5-7 
e-ASCID directive, 5-8 
ASCII character set, A-l 
-ASCII directive, 5-7 
ASCII, 
hexadecimal conversion, A-1l 


6-6 


32137. 3514 


operator, 3-1ll, 3-13 
strings, 3-11, 3-13, 5-6 
through 5-9 


string storage, 5-6 through 5-9 
-ASCIx storage directives, 5-6 
through 5-9 
e-ASCIZ directive, 5-8 
Assembler directives, 2-3, 5-1 
through 5-67, 6-1 through 6-29 
summary of, 5-1, 5-2, 6-2, B-1l 
through B-7 
Assembler functions, 
5-19 


5-17 through 


Assigning a value, 3-17 

Assignment statements, 3-17, 3-18 

Attributes, program section, 5-46 
through 5-50 

Autodecrement index mode, 
4-17 

Autodecrement mode, 4-7 

Autoincrement deferred index mode, 


4-15, 


4-15, 4-16, 4-17 
Autoincrement deferred mode, 4-6, 
4-7 
Autoincrement index mode, 4-15, 
4-16, 4-17 


Autoincrement mode, 4-6 


B* displacement specifier, 4-8, 
4-9, 4-12 
“B unary operator, 3-11, 3-12 
Base mode, 4-15, 4-17 
Binary operators, 3-15 through 
3-17, B-10 
Binary radix, 3-11, 3-12 
Blank lines, 2-2 
~BLKA directive, 
-BLKB directive, 
~-BLKD directive, 
-BLKF directive, 
»~BLKG directive, 
-BLKH directive, 
-BLKL directive, 
-BLKO directive, 
-BLKQ directive, 
-BLKW directive, 
~-BLKx directives, 5-9, 
Block labels, 3-7, 3-8 
Block storage directives, 
5-10 
Branch addresses, 3-8 
Branch instructions, 
Branch mode, 4-18 
Byte data, 
initializing memory with, 5-11, 
5-57 
reserving memory for, 
~BYTE directive, 5-11 


ah 
5-9, 
5-9 ’ 
a 
5-9, 
5-9, 
5-9, 
5-9, 
5-9, 
5-9, 


5-10 
5-10 
5-10 
5-10 
5-10 
5-10 
5=10 
5-10 
5-10 
o=10 
5-10 


5-9 v 


4-18 


5-9, 5-10, 


C 


“C operator, 3-15 
Call instruction, 
Character, 
indefinite repeat block, 
6-17 


SA214° 8322 


6-16, 


Index-1 


INDEX 


Character, (Cont.) 
separating, 3-3 
set, 3-l, 3-2 
set, ASCII, A-1l 
special, 3-1, 3-2, B-7, B-8 
strings, 3-12, 3-13, 5-6 
through 5-8 
Characters, counting, 6-9, 6-25 
Combining arguments in macros, 
6-6 
Comment field, 2-1, 2-4 
Complement operator, 3-15 
Concatenated program sections, 
5-48 
Concatenating arguments in 
macros, 6-6 
Conditional assembly blocks, 
5-30 through 5-36 
controlling listing of, 5-55, 
5-56 
one line block, 5-36 
subconditionals, 5-33 through 
5-35 
Condition tests, 5-30, 5-31 
CON program section attribute, 
5-48 
Continuation lines, 2-2 
Continuing program sections, 5-46 
Controlling listings, 5-55, 5-56 
Counted ASCII string storage, 5-7 
Counter, current location, 3-18 
Counting characters, 6-9, 6-25 
Counting macro arguments, 6-24 
Counts, repeat, 3-10, 5-11, 5-38, 
5-57, 5-58, 5-67 
Created local labels, 6-7, 6-8 
-CROSS directive, 5-12, 5-13 
Cross reference listing, 5-12, 
5-13 
Current location counter, 3-18 


D 


“D unary operator, 3-11, 3-12 
Data alignment, 5-4, 5-5 
Data, reserving memory for, 5-9 
Data, initializing memory with, 

address, 5-3 

ASCII, 5~6 through 5-8 

byte, 5-11, 5-57 

D floating, 5-16 

Double precision, 5-16 

F floating, 5-25 

floating-point, 5-16, 5-25, 

5-26, 5-28 

G floating, 5-26 

H floating, 5-28 

longword, 5-38 

octaword, 5-41 


Data, initializing memory 
with, (Cont.) 
packed decimal, 5-44 
quadword, 5-51 
Signed, 5-57, 5-58, 5-59 
word, 5-58, 5-67 
DBG argument, 5-18 
»-DEBUG directive, 5-14 
Debugging information, 5-14, 5-18 
Decimal/hexadecimal conversion, 
D-1 through D-4 
Decimal radix, 3-11, 3-12 
Decimal strings, 3-4, 3-5, 5-44 
-DEFAULT directive, 5-15 
Default program sections, 5-46, 
5-50 
Default radix, 3-12 
Default values of macro 
arguments, 6-3 
Deferred mode, 
autoincrement, 4-6, 4-7 
displacement, 4-9 
register, 4-5 
relative, 4-12 
Defining, 
labels, 2-2 
INacros, 6-19, 6-20 
opcodes, 5-42, 5-43 
Degree of precision, 3-4 
Deleting a macro, 6-22 
Delimited ASCII strings, 5-6 
Delimiters in macro arguments, 
6-4 through 6-6 
Descriptors, string, 5-8 
D_ floating data, 
initializing memory with, 5-16 
reserving memory for, 5-9, 5-10 
-D_FLOATING directive, 5-16 


Direct assignment statements, 
3-17, 3-18 
Directives, 2-3, 3-5, 5-1 through 
5-67, 6-1 through 6-29 
summary of, 5-1, 5-2, 6-2, B-1l 
through B-7 
-DISABLE directive, 5-17 through 
5-19 
LOCAL_BLOCK attribute, 3-8 
Disabling assembler functions, 
5-17 through 5-19 
Displacement, 
controlling default, 5-15 
deferred index mode, 4-15 
through 4-17 
deferred mode, 4-9 
index mode, 4-15 through 4-17 
mode, 4-7, 4-8 
specifier, 4-8, 4-9, 4-12 
Division, 3-15 
Documenting a program, 2-4 


Index-2 


INDEX 


-DOUBLE directive, 5-16 
Double precision, 3-4, 
Double-precision data, 
initializing memory with, 5-16 
reserving memory for, 5-9, 5-10 
»-DSABL directive, 5-17 through 
5-19 
DV arithmetic trap enable, 
3-14 


5-16 


3-13, 


E 


-ENABL directive, 
5-19 
-ENABLE directive, 
5-19 
LOCAL BLOCK attribute, 3-8 
Enabling assembler functions, 5-17 
through 5-19 
~-END directive, 
eENDC directive, 
through 5-35 
Ending, 
conditional assembly blocks, 
5-20, 5-30 through 5-35 
INacro definitions, 6-13, 6-19, 
6-20 
modules, 5-20 
repeat range definitions, 
6-14 through 6-17 
~-ENDM directive, 6-13, 6-19, 
e-ENDR directive, 6-13 through 
6-17 


5-17 through 


5-17 through 


5-20 


5-20, 5-30 


6-13, 


6-20 


eENTRY directive, 5-21 

5-39 
e-ERROR directive, 5-23 
Exclusive OR operator, 3-17 


Executable program sections, 5-46 


through 5-50 
EXE program section attribute, 
5-48 
Expanding a macro, 6-1, 6-2 
Exponent, 3-4 
Expressions, 3-9, 3-10 
evaluation of, 3-9 
floating point, 3-14 
restrictions on, 3-10 


Extended precision, 3-4, 5-28 

e-EXTERNAL directive, 5-24 

External symbols, 3-7, 5-24, 5-27, 
5-66 

%EXTRACT macro string operator, 
6-11, 6-12 

eEXTRN directive, 5-24 

~-EVEN directive, 5-24 


Exiting a macro, 6-13, 6-19, 6-20 


- 


“F operator, 3-14, 3-15 
Factors, repetition, 3-10, 
5-38, 5-57, 5-58, 5-67 
Field, 
comment, 2-1, 2-4 
label, 2-1 through 
operand, 2-1, 2-3, 
operator, 2-1, 2-3 
F_ floating data, 
initializing memory with, 5-25 
reserving memory for, 5-9, 5-10 
-F FLOATING directive, 5-25 
.FLOAT directive, 5-25 
Floating-point data, 
initializing memory with, 5-16, 


5-11 , 


2-3 
2-4 


5-25, 5-26, 5-28 
reserving memory for, 5-9, 5-10 
Floating-point expressions, 3-14 


Floating-point numbers, 3-3, 3-4, 
3-14, 3-15 
format of, 3-4 
rounding of, 5-17, 5-19 
truncation of, 5-17, 5-19 
Floating-point operator, 3-14 
Floating-point short literals, 
4-10 
Format, statement, 2-1 through 2-4 
Formatting with tabs, 2-1, 2-2 
FP register, 3-6, 3-14 
FPT attribute, 5-19 
Frame pointer, 3-6 
Functions, assembler, 
5-19 


5-17 through 


G 


GBL argument, 5-18, 5-19 

GBL program section attribute, 
5-48 

General mode, 4-14 

General registers, 3-5 

General register modes, 4-1 
through 4-11 

G floating data, 

“initializing memory with, 5-26 


reserving memory for, 5-9, 5-10 
~G_FLOATING directive, 5-26 
GLOBAL argument, 5-18, 5-19 
Global attribute, 5-48, 5-49 
GLOBAL directive, 5-27 
Global program sections, 5-48 
Global symbols, 2-2, 3-7, 3-17, 

5-18, 5-19, 5-24, 5-27, 5-66 

defining, 2-2 

weak, 5-66 


-GLOBL directive, 5-27 


Index-3 


INDEX 


H 


Hexadecimal/ASCII conversion, A-1 
Hexadecimal/decimal conversion, 
D-1 through D-4 
Hexadecimal radix, 
H floating data, 
initializing memory with, 5-28 
reserving memory for, 5-9, 5-10 
«H_FLOATING directive, 5-28 


3-11, 3-12 


I* addressing mode, 4-14, 4-15 

IDENT directive, 5-29 

Identifying a module, 5-29, 5-61 

-IF directive, 5-30 through 5-32 

-IF FALSE directive, 5-33 through 

~ 5-35 

-IF TRUE directive, 
5-35 

-IF_ TRUE FALSE directive, 5-33 

“through 5-35 

-I[FF directive, 

-IFT directive, 

-IFTF directive, 
5-35 

-IFx directives, 
5-35 

-IIF directive, 5-36 

Immediate conditional block, 

Immediate mode, 4-13, 4-14 

Inclusive OR operator, 3-15, 3-17 

Indefinite repeat blocks, 6-14, 
6-15 


5-33 through 


5-33 through 5-35 
5-33 through 5-35 
5-33 through 


5-33 through 


5-36 


Indefinite repeat character blocks, 


6-16, 6-17 
Index mode, 4-15 through 4-17 
Initializing memory with 

address data, 5-3 

ASCII data, 5-6 through 5-8 

byte data, 5-11, 5-57 

D floating data, 5-16 

floating-point data, 5-16, 5-25, 

5-26, 5-28 

G floating data, 5-26 

H floating data, 5-28 

longword data, 5-38 

octaword data, 5-41 

packed data, 5-44 

quadword data, 5-51 

word data, 5-58, 5-67 
Instructions, l-1l, 2-3, 

through C-8 

redefining, 5-42, 
Integer expressions, 
Integers, 3-3 
Internal symbols, 2-2, 
-IRP directive, 6-14, 
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6-20 
3-10 


5-43, 

3-9 v 
3-7, 3-17 
6-15 


»~IRPC directive, 6-16, 6-17 
IV arithmetic trap enable, 3-14 


K 


Keyword arguments in macros, 6-3, 
6-4 


L 


L* displacement specifier, 4-8, 
4-9, 4-12, 4-13 
Label, 
defining a, 
field, 2-1, 
local, 3-7, 
names, 2-2 
terminator, 2-2 
LCL program section attribute, 
5-48 
%LENGTH macro string operator, 
6-9 
Length of source line, 2-1 
Lexical operators, 6-8 through 
6-12 
~LIBRARY directive, 6-18 
Lines, continuation, 2-2 
eLIST directive, 5-37, 5-55, 
Listing, 
control of, 5-44, 5-55, 
cross reference, 5-13, 
table of contents, 5-59 
Literal mode, 4-10 through 4-12 
Literals, short, 4-10 through 
4-12 
Local label block, 
delimiters, 3-8 
disabling, 3-8, 5-17, 5-18 
enabling, 3-8, 5-17, 5-18 
restoring, 5-53 
saving, 5-54 
Local labels, 3-7, 3-8, 5-17, 5-18 
created, 6-7, 6-8 
Local program sections, 5-48, 
LOCATE macro string operator, 
6-10, 6-11 
Location counter, 3-18 
alignment, 5-4, 5-5, 5-24, 
Logical AND operator, 3-16 
Logical exclusive OR operator, 
3-17 
Logical inclusive OR operator, 
3-17 
~LONG directive, 
Longword data, 
initializing memory with, 5-38 
reserving memory for, 5-9, 5-10 
LSB argument, 3-8, 5-18 


2-2 
2-2 
3-8 


5-56 


5-56 
5-14 


5-49 


5-41 


5-38 


Index-4 


INDEX 


“M operator, 3-13, 3-14 
Machine instructions, 1-1 
-MACRO directive, 6-19, 6-20 
Macros, 6-1 through 6-29 
arguments in, 6-1 through 6-8 
calls to, 2-3 
controlling listing of, 5-55, 5-56 
definitions of, 6-19, 6-20 
deletion of, 6-22 
exiting from, 6-23 
expanding, 6-1, 6-2 
libraries containing, 6-18 
maximum line size, 2-2 
names of, 3-6, 6-13, 5-19, 
redefining, 6-19, 6-20 
string operators in, 6-8 through 
6-12 
-MASK directive, 5-21, 
Mask operator, 3-13, 
Mask, register save, 
5-21, 5-39 
eMCALL directive, 6-21 
-MDELETE directive, 6-22 
Messages, printing assembly, 5-23, 
5-45, 5-65 
eMEXIT directive, 6-23 


6-20 


ial BS, 
3-14 


3-13, 3-14, 


Mnemonic instructions, 3-5, C-l 
through C-8 
Modes, addressing, 2-3, 4-1 


through 4-18 
summary of, 4-2 through 4-4, 
B-1l1 through B-13 
Module, identifying, 5-29, 5-61 
Multiplication, 3-15 


Names, 
macro, 3-6, 
“Module, 5-61 
register, 3-5 
symbol, 3-6 
e-NARG directive, 6-24 
e-NCHR directive, 6-25 
Negative numbers, 3-3 
eNLIST directive, 5-39, 
5-56 
~-NOCROSS directive, 
5-40 
NOEXE program section attribute, 
5-48 
NOPIC program section attribute, 
5-48 
eNOSHOW directive, 
5-56 
NOSHR program section attributes, 
5-48 


6-13, 6-19, 6-20 


D009 


5-12, 5-13, 
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NOWRT program section attribute, 
5-49 

eNTYPE directive, 6-26 

Number of macro arguments, 6-1, 


6-24 
Numbers, 3-3 
floating point, 3-3, 3-4, 3-14, 
3-15, 5-16, 5-25, 5-26, 5-28 


integer, 3-3 
packed decimal, 3-4, 3-5, 5-44 
Numeric control operators, 3-14, 
3-15 


O 


“O unary operator, 3-11, 3-12 
-OCTA directive, 5-41 
Octal radix, 3-1ll, 3-12 
Octaword data, 
initializing memory with, 5-28 
reserving memory for, 5-9, 5-10 
-ODD directive, 5-41 
Opcodes, C-1 through C-8 
Gefining, 5-42, 5-43 
redefining, 5-42, 65-20 
-OPDEF directive, 5-42, 
Operand, 
descriptors, 5-43 
field, 2-1, 2-3 
generation directives, 
types, 6-26 
Operator, 
binary, 3-15 through 3-17, B-9 
field, 2-1, 2-3 
macro string, 6-8 through 6-12, 
B-10 
unary, 3-10 through 3-15, B-8, 
B-10 
OR operators, 3-17 
Overlaid program sections, 5-49 
OVR program section attribute, 5-49 


5-43 


5-52 


p 


Packed decimal strings, 
5-44 

»~PACKED directive, 5-44 

~-PAGE directive, 5-44 

Page ejection, 5-44 

Passing numeric values in macros, 
6-7 

PC register, 3-6 

Permanent symbols, 3-5, C-l 

PIC program section attribute, 
5-49 

Position-independent code, 

Precision of floating-point 
numbers, 3-4 


3-4, 3-5, 


5-49 


Index-5 


INDEX 


-PRINT directive, 5-45 

Printing assembly messages, 5-23, 
5-45, 5-65 

Privileged shareable image attri- 
bute, 5-49 

Program counter, 3-6 

Program counter modes, 4-11 
through 4-14 

Program section attributes, 5-48, 
5-49 

default, 5-49 

Program sections, 5-46 through 

5-50, 5-53, 5-54 


Q 


QUAD directive, 5-51 

Quadword data, 
initializing memory with, 5-51 
reserving memory for, 5-9, 5-10 


R 


Radix control, 3-11, 3-12 
Radix default, 3-11 
Radix operators, 3-11, 3-12 
in macro arguments, 6-5 
Real numbers, 3-3, 3-4 
Redefining 
instructions, 5-42, 6-20 
macros, 6-19, 6-20 
opcodes, 5-42, 6-20 
-REFn directive, 5-52 
Register, 
deferred index mode, 4-15 
through 4-17 
deferred mode, 4-5 
mask operator, 3-13, 3-14 
mode, 4-5 
names, 3-5, 3-6 
save mask, 3-13, 3-14, 5-21, 
5-39 
Relative, 
default displacement, 5-15 
deferred index mode, 4-15, 4-17 
deferred mode, 4-12 
index mode, 4-15, 4-17 
mode, 4-ll, 4-12 
Relocatable program sections, 
5-49, 5-50 
REL program section attribute, 
5-49 
Repeat blocks, 6-28, 6-29 
character, indefinite repeat, 
6-16, 6-17 
controlling listing of, 5-55, 
5-56 
indefinite, 6-14, 6-15 


Repeat counts, 3-10, 5-11, 5-38, 
5-57, 5-58, 5-67 

~REPEAT directive, 6-28, 6-29 

Repeating a block of code, 6-28, 

~ 6-29 

Repetition factors, 3-10, 5-1l, 
5-38, 5-57, 5-58, 5-67 

-REPT directive, 6-28, 6-29 

eRESTORE directive, 5-53 

«RESTORE _PSECT directive, 5-53 

Restoring a program section, 5-53 

Reserved bits in entry mask, 3-14, 
5-21 

Reserving storage, 5-9 

Rounding floating-point numbers, 
5-19 


S 


S* addressing mode, 4-10 through 
4-12 
-SAVE directive, 5-54 
-SAVE PSECT directive, 5-54 
Saving a program section, 5-54 
Saving local label block, 5-54 
-SBTTL directive, 5-60 
Sections, program, 5-46 through 
5-50, 5-53, 5-54 
Separating characters, 3-3 
Shareable images, 5-62 through 
5-64 
Shareable program sections, 5-49 
Shift operator, arithmetic, 3-16 
Short literals, 4-10, 4-11 
-SHOW directive, 5-55, 5-56 
SHR program section attribute, 5-49 
-SIGNED BYTE directive, 5-57 
Signed data storage, 5-57 through 
5-59 
-SIGNED WORD Girective, 5-58, 
5-59 
Single precision, 3-4, 5-25 
Single-precision data, 
initializing memory with, 5-25 
reserving memory for, 5-9, 5-10 
Source lines, 
blank, 2-2 
continuing, 2-2 
format of, 2-1 
length of, 2-1 
SP register, 3-6 
Special characters, 3-1, 3-2, 
B-7, B-8 
Stack pointer, 3-6 
Starting address, 5-21, 5-22 
Statement format, 2-1 through 2-4 
Storage, reserving, 5-9 
ASCII, 5-6 through 5-8 
block, 5-9 
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Storing, 
address, 5-3 
ASCII, 5-6 through 5-8 
byte, 5-11, 5-57 
D floating, 5-16 
double-precision, 
F floating, 5-25 
floating-point, 5-25 
G_ floating, 5-26 
H_ floating, 5-28 
longword, 5-37 
octaword, 5-28 
packed decimal, 5-42 
Signed, 5-57, 5-58 
quadword, 5-51 
word, 5-58, 5-67 
String, 
arguments in macros, 6-4 through 
6-6 
ASCII, 3-12, 3-13, 5-6 
descriptors, 5-8 
operators, 6-8 through 6-12 
packed decimal, 3-4, 3-5, 5-44 
Subconditional assembly blocks, 
5-33 through 5-35 
-SUBTITLE directive, 
Subtraction, 3-15 
Suppressing symbol table listing, 
5-17, 5-18 
Symbols, 3-5, 3-17 
external, 3-7, 5-24, 5-27, 5-66 
global, 2-2, 3-7, 3-17, 5-18, 
5-19, 5-24, 5-27, 5-66 
internal, 3-7 
names of, 3-6 
permanent, 3-5, C-l 
undefined, 5-17 through 5-19 
user-defined, 2-2, 3-6 


5-16 


5-60 


T 


Tab formatting, 2-l, 2-2 


Table of contents, listing, 5-60 
TBK argument, 5-18 
Temporary labels, 3-7, 3-8 


Terms, 3-9 

Testing conditions, 5-30 through 
5-32 

Textual operators, 3-12 through 
3-14 

-TITLE directive, 5-61 

Traceback information, 5-18 

eTRANSFER directive, 5-62 through 


5-64 

Trap enable, arithmetic, 3-13, 
3-14 

Truncating floating-point number, 
5-19 


Type of operand in macros, 6-24 


U 


Unary operators, 
3-15, B-9 
in macro arguments, 6-5 
summary of, 3-11, B-9 
Undefined symbols, 5-17 through 
5-19 
User-defined program sections, 
5-46 through 5-50 
User-defined symbol, 2-2 
User-generated 
errors, 5-23 
messages, 5-45 
opcodes, 5-42, 
operands, 5-52 
warnings, 5-65 


V 


Value, passing arguments by, 6-7 

VEC program section attribute, 
5-49 

Vector, transfer, 5-62 through 
5-64 

Version number, 5-29 


W 


W* displacement specifier, 4-8, 
4-9, 4-12, 4-13 
eWARN directive, 5-65 
Warning directive, 5-65 
WEAK directive, 5-66 
Weak symbols, 5-66 
Word data, 
initializing memory with, 5-58, 
5-67 
reserving memory for, 5-9, 5-10 
WORD directive, 5-67 
Write protecting program sections, 
5-46, 5-49, 5-50 
WRT program section attribute, 
5-49 


3-11 through 


5-43 


X 


“X unary operator, 3-12 


Z 


Zero terminated ASCII string, 5-8 
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Did you find this manual understandable, usable, and well-organized? 
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